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内 容 简 介 


本 书 对 Android 应 用 程序 开发 的 基本 概念 和 技术 进行 了 系统 的 讲解 ,并 通过 简单 易 懂 的 示例 说 明 
了 其 具体 实现 过 程 。 通 过 本 书 的 学 习 , 可 以 牢固 掌握 Android 编程 技术 的 基本 概念 ,原理 和 编程 方法 ， 
通过 实践 的 灵活 运用 ,能 够 进行 应 用 程序 的 实际 开发 。 

全 书 分 为 三 个 部 分 , 共 10 章 。 第 一 部 分 第 1 章 详细 介绍 Android 系统 的 体系 结构 ,应 用 程序 开发 
环境 和 调试 环境 的 搭建 ;第 二 部 分 包括 第 2 一 4 章 ,详细 介绍 用 户 界面 的 设计 方法 、 常 用 布局 ,基本 和 高 
级 控件 ,事件 处 理 机 制 等 实现 Android 用 户 界面 的 基本 知识 ,以 及 用 户 浏览 模式 中 菜单 模式 和 动作 条 模 
式 中 各 种 应 用 的 具体 实现 ;第 三 部 分 包括 第 5 一 10 章 , 详 细 介 绍 Android 平台 的 高 级 知识 ,包括 消息 与 
广播 服务 .多 任务 与 服务 .实现 应 用 程序 的 数据 存储 访问 数据 资源 的 接口 ContentProvider、 触 摸 事件 处 
理 、 定 位 服务 和 Google 地 图 应 用 。 

本 书 适用 于 对 Java 编程 有 一 定 基础 、 希 望 掌握 Android 程序 设计 技术 的 读者 ,也 适合 作为 高 等 学 校 
计算 机 专业 教材 ,或 可 作为 Android 程序 设计 的 培训 教材 。 
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关于 本 书 


Android 是 一 个 以 Linux 为 基础 的 开放 源码 的 操作 系统 ,中 文 称 为 “ 安 
卓 ”。 目 前 , 安 卓 已 发 布 的 最 新 版 本 为 Android 4.3。2007 年 11 月 ,Google 
与 84 家 硬件 制造 商 、 软 件 开发 商 以 及 电信 运营 商 成 立 手持 设备 联盟 ,共同 研 
发 改良 Android 系统 ,随后 ,Google 以 Apache 免费 开放 源 代码 许可 证 的 授 
权 方 式 , 发 布 了 Android 的 源 代码 。 

随 着 3G 和 触摸 屏 的 技术 发 展 ,移动 智能 终端 , 即 智 能 手机 和 平板 电脑 ， 
已 经 成 为 人 们 日 常 通信 和 信息 处 理 的 工具 ,移动 互联 网 正在 改变 人 们 的 交 
流 和 生活 方式 。 作 为 移动 智能 终端 两 大 操作 系统 之 一 ,Android 的 影响 力 已 
经 渗透 到 移动 领域 以 外 ,特别 是 物 联 网 和 电视 等 平台 ,Android 应 用 程序 也 
由 个 人 应 用 逐步 向 企业 应 用 扩展 。Android 人 才 就 业 前 景 非常 广泛 。 

我 们 编写 本 书 主要 有 两 个 目的 : 

(1) 全 面 系统 地 提供 Android 开发 的 基础 知识 。 在 本 书 的 编写 中 把 
Android 的 基础 知识 ,与 自己 的 教学 经 验 和 学 习 的 体会 结合 起 来 ,希望 能 够 
引导 Android 技术 学 习 者 快速 入 门 ,很 快 系统 地 掌握 Android 编程 技术 。 

(2) 提供 Android 培训 教育 的 教材 。 由 于 目前 Android 技术 较 新 ,无 论 
是 相关 书籍 .培训 还 是 大 学 教育 ,都 处 于 初级 阶段 。 本 书 内 容 中 的 概念 和 原 
理 主要 参考 Android 的 官方 网 站 ,尽量 做 到 既 准 确 又 易于 理解 ,代码 示例 均 

本 书 主要 围绕 Android 技术 ,讲述 如 何 利用 Android 相关 技术 ,开发 移 
动 终端 的 互联 网 应 用 程序 。 全 书 共 分 为 10 章 。 

第 1 章 概述 使 用 Android 技术 在 移动 终端 开发 的 基础 知识 ,包括 
Android 的 基本 常识 和 技术 框架 ,并 介绍 如 何 搭建 Android 开发 环境 和 
Android 应 用 程序 项 目的 结构 ,引入 了 移动 设备 模拟 器 的 概念 。 

第 2 章 主 要 介绍 Android 四 大 基础 组 件 之 一 的 Activity\ 布 局 和 资源 的 
概念 ,介绍 如 何 使 用 Android 的 Activity 和 布局 管理 器 来 设计 移动 终端 的 用 
户 图 形 界 面 。 


Ne/ 基于 hdroid 平 台 的 移动 互联 网 开发 


第 3 章 主要 介绍 三 部 分 内 容 。 首 先 阔 述 Android 图 形 界面 的 事件 监听 和 处 理 机 制 。 
然后 介绍 图 形 界面 中 的 常用 视图 控件 如 何 使 用 及 进行 事件 处 理 , 其 中 包括 按钮 控件 中 的 
Button、RadioButton、Checkbox、ToggleButton 和 Toast 控件 ,以 及 文本 控件 中 的 Text- 
View 和 EditText。 最 后 用 实例 说 明 如 何 对 界面 的 进行 处 理 , 使 其 显示 效果 多 样 化 。 

第 4 章 主要 是 Android 应 用 程序 浏览 模式 的 介绍 。 从 Android 3. 0 开始 ,Android 系 
统 的 应 用 浏览 模式 发 生 了 较 大 的 改变 ,引入 了 向 上 和 返回 的 设计 原则 ,并 且 提 供 相应 的 设 
计 组 件 ,其 中 包含 菜单 ,动作 条 和 浏览 抽 导 等。 这 一 章 主要 介绍 了 菜单 模式 和 动作 条 模式 
的 实现 。 

第 5 章 主 要 介绍 Android 系统 的 应 用 程序 之 间 发 送 和 接收 消息 的 机 制 。 介 绍 
Android 实 现 发 送 和 接收 消息 的 Intent、BroadcastReceiver 组 件 与 Notification 组 件 的 概 
念 \ 用 途 和 实现 方法 。 

第 6 章 主要 介绍 Android 系统 的 多 任务 机 制 、 主 线程 的 概念 和 实现 多 任务 的 原理 ,以 
及 在 Android 系统 中 如 何 使 用 Handler 或 AsyncTask 实现 应 用 程序 的 多 任务 。 在 多 任 
务 的 基础 上 ,本 章 的 另 一 部 分 介绍 Android 的 四 大 组 件 之 一 的 Service 的 概念 和 基本 知 
识 , 以 及 在 应 用 程序 中 实现 Service 的 两 种 方式 。 

第 7 章 主要 介绍 Android 系统 实现 应 用 程序 数据 存储 的 机 制 ,包括 用 户 偏好 的 存 取 、 
文件 的 读 取 与 保存 和 SQLite 数据 库 的 创建 与 操作 。 

第 8 章 主要 介绍 Android 的 四 大 组 件 之 一 的 ContentProvider 的 概念 和 相关 基本 知 
识 , 以 及 如 何 创 建 和 使 用 ContentProvider, 如 何 通过 数据 绑 定 , 使 用 适配器 、 视 图 对 象 和 
SQLite 数据 库 的 ContentProvider 实现 数据 加 载 ,最 终 向 用 户 显示 数据 。 

第 9 章 主要 介绍 Android 有 关 触 摸 屏 的 应 用 程序 开发 ,包括 触摸 事件 的 定义 、 触 摸 事 
件 的 传递 机 制 、 触 摸 点 移动 的 速率 跟踪 、 手 势 识 别 和 拖 放 处 理 。 

第 10 章 分 两 个 部 分 。 第 一 部 分 主要 介绍 Android 应 用 程序 如 何 通过 GPS 和 
Android 网 络 位 置 提 供 器 ,获取 位 置信 息 , 实 现 定位 服务 。 第 二 部 分 主要 介绍 Android 应 
用 程序 如 何 使 用 Google 公司 提供 的 Google Maps Android API, 实 现 应 用 程序 中 的 
Google 地 图 的 功能 。 

本 书 基本 宅 括 了 Android 技术 体系 中 的 基础 部 分 ,并 使 用 短小 易 懂 的 例子 详细 说 明 
如 何 应 用 。 本 书 的 不 足 之 处 在 于 ,由 于 时 间 和 篇 幅 的 原因 ,本 书 只 是 编写 了 Android 技术 
中 最 基础 的 部 分 ,Android 技术 中 关于 网 络 互联 、 动 画 、 游 戏 ` 服 务 器 和 其 他 更 深层 次 的 应 
用 等 都 没有 涉及 ,不 能 全 面 覆 盖 Android 技术 ,并 且 , 由 于 水 平 的 原因 ,在 本 书 的 编写 过 程 
中 可 能 存在 一 些 对 Android 技术 及 移动 互联 网 技术 认识 不 全 面 或 者 表述 错漏 的 地 方 , 冤 
请 读者 批评 指正 。 


读者 对 象 
本 书 是 Android 技术 入 门 的 基础 类 书籍 ,通过 本 书 的 学 习 可 以 牢固 掌握 Android 编 


程 技术 的 基本 概念 、 原 理 和 编程 方法 ,能 够 进行 应 用 程序 的 实际 开发 。 
本 书 的 读者 对 象 可 以 是 具有 Java 编程 基础 ,对 移动 互联 网 应 用 感 兴趣 ,但 不 具有 


Android 开发 经 验 的 编程 技术 人 员 ; 也 可 以 是 职业 教育 、 高 等 教育 和 技术 培训 的 师 生 。 
致谢 


在 本 书 的 写作 过 程 中 ,得 到 了 很 多 人 士 的 悉心 帮助 ,在 此 谨 向 给 予 本 书 帮 助 的 诸位 及 
本 书 所 参考 的 官方 网 站 和 网 站 社区 表示 诚 击 的 感谢 。 

特别 感谢 对 外 经 济 贸易 大 学 信息 学 院 和 远程 学 院 , 为 本 书 的 教学 和 实践 提供 了 支持 
平台 。 
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Android 开发 基础 


Android 是 一 种 以 Linux 为 基础 的 开放 源 代 码 操作 系统 ,主要 应 用 于 便携 设备 。 目 
前 尚未 有 统一 的 中 文 名 称 , 中 国 大 陆地 区 较 多 人 使 用 “ 安 卓 ”或 “ 安 致 ”"。Android 操作 系 
统 最 初 由 Andy Rubin 开发 ,主要 支持 手机 。2005 年 由 Google 收购 注资 ,并 组 建 开 放手 
机 联盟 进行 开发 改良 ,逐渐 扩展 到 平板 电脑 及 其 他 领域 上 。Android 的 主要 竞争 对 手 是 
苹果 公司 的 iOS 以 及 RIM 的 Blackberry OS。2011 年 第 一 季度 ,Android 在 全 球 的 市 场 
份额 首次 超过 塞 班 系统 , 跃 居 全 球 第 一 。2012 年 2 月 的 数据 显示 ,Android 占据 全 球 智 能 
手机 操作 系统 市 场 52. 5% 的 份额 ,中 国 市 场 占有 率 为 68. 4%。 


1.1 Android 入 门 


Android 系统 是 基于 Linux 平台 的 智能 手机 操作 系统 。Android 是 Google 于 2007 
年 11 月 5 日 宣布 发 布 的 ,是 一 个 开源 的 平台 , 它 由 操作 系统 .中 间 件 .用 户 界面 和 应 用 软 
件 等 部 分 组 成 。 

Android 系统 采用 软件 堆 层 (Software Stack, 又 名 软件 一 层 ) 的 系统 架构 ,由 多 个 程 
序 组 合 来 完成 一 个 共同 的 任务 。Android 的 系统 架构 主要 分 为 三 个 层次 ,底层 以 Linux 
内 核 为 基础 ,由 C 语言 开发 ,是 移动 设备 的 操作 系统 ,只 提供 基本 功能 ;中 间 层 包括 函数 
库 (Library) 和 虚拟 机 (Virtual Machine) ,由 C++ 开发 ;最 上 层 是 各 种 应 用 软件 组 成 , 包 
括 通话 程序 ,短信 程序 和 游戏 等 。 

Android 系统 作为 一 个 移动 开放 平台 ,提供 了 与 Apple 移动 系统 不 同 的 生态 环境 。 
任何 手机 厂商 都 可 以 免费 使 用 Android 系统 来 定制 自己 的 产品 ,而 且 Android 系统 提供 了 标 
准 的 SDK, 应 用 软件 可 以 由 第 三 方 开 发 者 独立 完成 。Android 应 用 的 开发 语言 是 Java。 
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从 Android 1.5 版 本 开始 ,Android 选择 使 用 甜点 名 称 作 系统 版 本 的 代号 ,其 版 本 的 
名 称 分 别 为 : 纸杯 蛋糕 (Cupcake) 、 甜 甜 圈 (Donut)、 松 饼 (Eclair) 、 冻 酸奶 (Froyo) 、 姜 饼 
(Gingerbread) 、 蜂 梨 (Honeycomb) 冰激凌 三 明治 (Ice Cream Sandwich) ,目前 最 新 发 布 
的 版 本 4. 3 为 果冻 豆 (Jelly Bean) 。 如 果 使 用 版 本 名 称 的 英文 名 的 首 字母 进行 排序 ,就 会 
发 现 它们 是 英文 字母 的 首 字母 的 排序 ,从 C 开始 到 丁 .下 一 个 版 本 的 首 字母 应 该 为 民 , 大 
家 可 以 猜 一 猜 Google 会 用 什么 来 命名 。 
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图 1.1 是 2013 年 10 月 2 日 Google 的 统计 数据 ,是 7 天 中 访问 Google Play 网 站 
Android 设备 的 版 本 分 布 图 。 可 以 看 出 目前 手机 上 用 得 最 多 的 版 本 为 Jelly Bean, 如 果 要 
发 布 你 的 应 用 ,需要 选择 适合 的 Android 版 本 。 各 版 本 的 详细 分 布 数据 见 表 1-1。 


Jelly Bean 


Ice Cream Sandwich 


Honeycomb Gingerbread 


图 1.1 Android 版 本 分 布 


表 1-1 Android 版 本 分 布 


版 本 代 号 API 百分比 

2.2 Froyo 8 2.2% 
2 Gingerbread 10 28.5% 
3.2 Honeycomb 13 0.1% 
4. 0. 3 一 4. 0. 4 Ice Cream Sandwich 15 20.6% 
4.1.x 16 36.5% 
4.2.x Jelly Bean 17 10.6% 
4.3.x 18 1.5% 
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Android 技术 架构 如 图 1. 2 所 示 。Android 系统 架构 由 5 个 部 分 组 成 ,从 底层 到 上 


层 , 是 Linux Kernel、Android Runtime、Libraries、Application Framework 和 
Applications。 如 果 你 是 一 个 Android 应 用 开发 者 ,只 需要 了 解 Applications 和 
Application Framework; 如 果 你 是 嵌入 式 和 硬件 移植 的 开发 者 ,还 需要 了 解 Libraries、 
Android Runtime 和 Linux Kernel 这 几 个 部 分 。 

1. Linux Kernel 

Android 基于 Linux 2.6 提供 操作 系统 的 核心 系统 服务 ,例如 ,安全 、 内 存 管理 ,进程 
管理 \ 网 络 堆 栈 、 驱 动 模型 等 。Linux Kernel 也 可 以 看 作 硬 件 和 软件 之 间 的 抽象 层 , 它 隐 
藏 具 体 硬件 细节 而 为 上 一 层 提 供 统一 的 服务 。 这 种 类 似 计算 机 网 络 的 分 层 思 想 , 使 用 相 
邻 下 一 层 提供 的 服务 ,为 相 邻 的 上 一 层 提 供 统一 的 服务 ,屏蔽 了 本 层 及 以 下 一 层 的 差异 ， 
当 本 层 及 以 下 一 层 发 生 了 变化 不 会 影响 到 上 一 层 。 
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图 1.2 Android 技术 架构 


2. Android Runtime 

Android 系统 中 包含 一 个 核心 库 的 集合 ,提供 大 部 分 在 Java 编程 语言 核心 类 库 中 可 
用 的 功能 。 每 一 个 Android 应 用 程序 都 是 Dalvik 虚拟 机 中 的 实例 ,运行 在 它们 自己 的 进 
程 中 。Dalvik 虚拟 机 本 身 的 设计 ,决定 了 在 一 个 硬件 设备 上 可 以 高 效 地 运行 多 个 Dalvik 
虚拟 机 。Dalvik 虚拟 机 可 执行 文件 的 后 缀 是 . dex。dex 文件 格式 是 专 为 Dalvik 设计 的 一 
种 压缩 格式 ,适合 内 存 和 处 理 器 速度 有 限 的 系统 读 取 。 

大 多 数 虚拟 机 包括 JVM 都 是 基于 栈 的 ,而 Dalvik 虚拟 机 则 是 基于 寄存 器 的 。 两 种 
架构 各 有 优 劣 ,一 般 而 言 , 基 于 栈 的 机 器 需要 更 多 指令 ,而 基于 寄存 器 的 机 器 指令 更 大 。 
Java 的 二 进 制 代码 文件 . class 文件 可 以 通过 工具 dx 转换 成 . dex 格式 ,使 其 可 以 在 
Android 系统 内 执行 。 一 个 dex 文件 通常 会 有 多 个 . class。 由 于 dex 有 时 必须 进行 优化 ， 
会 使 文件 大 小 增加 1 一 4 倍 ,以 ODEX 结尾 。Dalvik 虚拟 机 依赖 于 Linux 内 核 提 供 基本 
功能 ,如 线程 和 底层 内 存 管理 。 

3. Libraries 

Android 包含 一 个 C/C++ 库 的 集合 , 供 Android 系统 的 各 个 组 件 使 用 , 这 就 是 
Libraries。 这 些 功 能 通过 Android 的 应 用 程序 框架 (Application Framework) 提 供给 开发 
者 。 下 面 是 常用 的 一 些 核 心 库 。 

。 系统 C 库 一 一 标准 C 系统 库 (Libc) 的 BSD 衍生 ,调整 为 基于 能 入 式 Linux 设备 。 

。 媒体 库 一 一 基于 PacketVideo 的 OpenCORE。 这 些 库 支持 播放 和 录制 许多 流行 

的 音频 和 视频 格式 ,以 及 静态 图 像 文件 ,包括 MPEG4、H. 264、MP3、AAC、AMR、 


JPG、PNG。 

。 界面 管理 一 一 管理 访问 显示 子 系统 和 无 颖 组 合 多 个 应 用 程序 的 二 维和 三 维 图 
形 层 。 

。 LibWebCore 新 式 的 Web 浏览 器 引擎 .驱动 Android 浏览 器 和 内 嵌 的 Web 视图 。 


SGI 一 一 基本 的 2D 图 形 引擎 。 

3D 库 一 一 基于 OpenGL ES 1.0 API 的 实现 。 库 使 用 硬件 3D 加 速 或 包含 高 度 优 
化 的 3D 软件 光栅 。 

位 图 和 矢量 字体 这 染 。 


FreeType 
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。 SQLite 所 有 应 用 程序 都 可 以 使 用 的 强大 而 轻 量 级 的 关系 数据 库 引 擎 。 

4. Application Framework 

Android 提供 开放 的 Application Framework( 应 用 框架 ) ,应 用 开发 者 可 以 方便 地 设 
计 丰 富 和 新 颖 的 应 用 程序 。 通 过 应 用 框架 ,开发 者 能 够 自由 地 利用 设备 硬件 、 使 用 访问 位 
置信 息 ,运行 后 台 服 务 、 设 置 闹钟 ,并 且 向 状态 栏 添 加 通知 等 功能 。 由 于 这 个 应 用 开发 框 
架 是 完全 开放 的 ,应 用 开发 者 能 够 使 用 框架 的 核心 功能 。 

设计 应 用 框架 的 目的 在 于 方便 组 件 的 重用 ,简化 应 用 程序 的 开发 ,而 且 应 用 程序 都 可 
以 发 布 和 使 用 应 用 框架 中 的 功能 。 应 用 框架 主要 是 由 下 面 的 功能 组 成 的 : 

。 视图 系统 (View System) 一 一 包括 丰富 的 、 可 扩展 的 视图 集合 ,可 用 于 构建 一 个 应 
用 程序 ,如 列表 、 网 格 ,文本 框 、 按 钮 ,甚至 是 内 蔡 的 网 页 浏览 器 。 
内 容 提 供 者 (Content Providers) 使 应 用 程序 能 访问 其 他 应 用 程序 (如 通信 
录 ) 的 数据 ,或 共享 自己 的 数据 。 
资源 管理 器 (Resource Manager) 一 一 提供 访问 非 代码 资源 ,如 本 地 化 字符 串 、 图 


形 和 布局 文件 。 

。 通知 管理 器 (Notification Manager) 一 一 使 所 有 的 应 用 程序 能 在 状态 栏 显 示 自 定 
义 警告 。 

。 活动 管理 器 (Activity Manager) 一 一 管理 应 用 程序 生命 周期 ,提供 通用 的 导航 回 
退 功能 。 


5. Applications 

Android 配置 一 个 核心 应 用 程序 集合 ,包括 电子 邮件 客户 端 \SMS 程序 .日 历 . 地 图 、 
浏览 器 、 联 系 人 和 其 他 设置 。 所 有 应 用 程序 都 是 用 Java 语言 写 的 。 我 们 将 来 开发 的 应 用 
就 是 在 这 个 层次 。 


1.2 Android 开发 环境 搭建 


在 进行 Android 应 用 程序 开发 之 前 ,需要 搭建 Android 应 用 程序 开发 环境 。 我 们 在 
这 本 书 采用 开源 的 Java 集成 开发 环境 Eclipse 作为 开发 工具 ,并 添加 必需 的 Android 
SDK 和 其 他 插件 。 

对 于 新 开发 者 来 说 ,Android 的 官方 网 站 http://developer. android. com 提供 了 包含 
Android SDK 的 Eclipse 安装 包 链 接 , 开 发 者 可 以 直接 从 链接 下 载 支 持 Android 系统 的 
Eclipse 安装 包 。 但 这 里 还 介绍 分 别 安装 各 包 的 步骤 ,以 便 开发 者 学 习 。 按 照 Android 开 
发 环境 的 安装 顺序 ,可 以 将 这 个 过 程 分 为 4 大 步骤 : 

。 安装 Eclipse 开发 环境 。 

。 安装 Android SDK 。 

。 安装 Eclipse ADT 插件 。 

。 安装 Google Play Service SDK 。 

如 果 读 者 已 经 熟悉 Eclipse 开发 环境 的 安装 ,可 以 跳 过 1. 2. 1 节 , 直 接 阅读 1. 2. 2 节 
及 后 面 的 内 容 。 
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Eclipse 开发 环境 的 安装 包括 JDK 的 安装 、 下 载 和 安装 Eclipse 以 及 配置 Eclipse 三 
个 部 分 。 

1. JDK 的 安装 

从 Sun 公司 发 布 的 JDK 的 官方 网 站 下 载 Windows 版 本 的 JDK 安装 软件 ,最 新 版 本 
为 JDK 1.7。 

下 载 后 选择 所 安装 的 磁盘 和 目录 ,判断 磁盘 空间 是 否 够 用 。 默 认 状 态 下 JDK 安装 在 
启动 盘 的 C:\Program Files\java 目录 下 。 

运行 JDK 安装 包 , 根 据 安装 向 导 完 成 JDK 的 安装 。 安 装 完成 后 ,在 Windows 进入 
行 命令 cmd 窗口 ,测试 安装 结果 。 

2. 下 载 和 安装 Eclipse 

从 Eclipse 官方 网 站 下 载 最 新 版 本 的 Eclipse (http://www. eclipse. org/ 
downloads/)。 请 选择 Eclipse IDE for JavaEE Developers, 目 前 的 版 本 是 3.7. 1。 

下 载 Eclipse 后 ,将 压缩 包 直接 解压 到 硬盘 上 ,会 新 建 一 个 eclipse 目录 存放 Eclipse 
的 文件 。 假 设 解压 缩 到 DD 盘 , 则 Eclipse 安装 在 D:\eclipse 目录 下 。 

3. 配置 Eclipse 

进入 Eclipse, 首 先 看 到 欢迎 界面 。 

关闭 欢迎 界面 ,可 以 看 到 默认 状态 下 Eclipse 平台 的 各 个 视图 , 见 图 1.3。 


File Edit Navigate Search Project Run Window Help 
中 ”加 同名 "Or BOOO7. 04 SavaE] 


们 vv 下 


= SOFou SATask] “| 


(An outline is not available. 


[ 克 Moreer Dope] msoven| oo onppatl =E) 
Oitems | 
Description Resource Path 


图 1.3 ”Eclipse 开发 界面 


选择 Window>Preferences, 打 开 Preferences 对 话 框 查看 Eclipse 的 选项 ,检查 JRE 
的 安装 是 否 正确 , 见 图 1.4。 同 时 学 习 使 用 其 他 配置 项 。 
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type filter text 


Sr rr 


Installed JREs 


el Add, remove or edit JRE definitions. By default, the check ~ 
> Mat added to the build path of newly created Java projects. 
Data Managemet 
Help Installed JREs: 
InstalVUpdate Name Location Type 
je Mehjre7 。 CANProgram Filesyavayjre7 Standard 
Appearance 


» Build Path 
» Code Style 


图 1.4 Eclipse 的 JRE 设 置 
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Eclipse 安装 完成 后 ,进行 Android SDK 安装 ,分 为 两 个 步骤 。 

1. 下 载 Android SDK 安装 程序 

从 http://developer. android. com/sdk/index. html 下 载 最 新 的 安装 程序 ,并 安装 。 
2. 添加 平台 和 其 他 组 件 


使 用 Android SDK Manager( 该 工具 包含 在 SDK starter 包 中 ) 来 下 载 必 要 的 SDK 


组 件 到 你 的 开发 环境 中 。 


如 果 使 用 的 是 Windows 安装 程序 , 它 会 在 安装 结束 后 自动 运行 Android SDK 
Manager, 如 图 1.5 所 示 。 只 需要 接受 推荐 的 组 件 集 并 安装 就 可 以 了 。 当 然 也 可 以 手动 
运行 Android SDK Manager。 在 Linux 系统 中 ,打开 终端 并 进入 tools/ 目录 ,然后 执行 


Android, 弹 出 图 1. 5 所 示 的 界面 ,可 以 浏览 SDK Repository 并 选择 新 的 或 更 新 的 组 件 。 
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在 Eclipse 环境 中 编写 Android 应 用 程序 ,通过 Android SDK 的 调用 ,可 以 直接 使 月 


日 


Eclipse 进行 编译 。 但 Android 应 用 程序 最 终 是 运行 在 手机 上 ,因此 需要 一 个 手机 的 模拟 


运行 环境 来 测试 Android 应 用 程序 的 运行 状况 。 安 装 Eclipse ADT 插件 ,可 以 使 Eclips 
启动 智能 手机 的 模拟 器 ,完成 在 Eclipse 上 的 Android 应 用 程序 模拟 运行 测试 。 

安装 Eclipse ADT 插件 可 以 在 线 安装 ,也 可 以 下 载 到 本 地 手动 安装 。 

1. 下 载 ADT 插件 

。 启动 Eclipse, 选 择 Help>Install New Software… 。 

。 单 击 右 上 角 的 Add 按钮 。 


e 
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到 Android SDK Hanager 
Packagss Tools 
SDK Path: D Wairoi 
Packages 
二 Nane | Status 
旦 问 四 Tools 
回 基 Android SDK Tools 亏 Installed 
口 党 Mndroid SDK Platforn-tools 8 起 Instaled 
日 口 国 ndroid 4.0 (FI 14) 
Docmentation for Android SDK 荐 Installed 
口 沉 SDK Platform 起 Instaled 
怕人 @@ Suples for SOK 志 Instulled 
口 壳 AM EABI vTa System Inage 亡 Instaled 
日 口 图 Mnaroid 3.2 QFI 13) 
口 党 SDK Platform 厂 Inastaled 
口 @@ smples for SDK 醉 Installed 
日 口 国 ndroid 3.1 OFI 12) 
口 常 SDK Platform 其 Instuled 
日 @@ Suples for SDk 邯 Installed 
日 器 园 airoid 3.0 OPI 11) 
器 壳 SDK Platform 其 Instaled 


Show: MUpdates/New MJInstalled Dobsolete Select New/Vpdates Install packages, 
Sort by: OAPI level ORepository Desslect A Delete packages 


[CCCITTT TT 


Patching https://d1-ssl. google con/android/repository/addons_list. xnl 


图 1.5 Android SDK Manager 界面 


。 在 Add Repository 对 话 框 中 ,输入 名 称 *ADT Plugin” 以 及 如 下 地 址 : 
https://dl- ssl.google.cam/android/eclipse/ 


注意 : 如 果 获 取 插 件 有 问题 ,使 用 "http” 协 议 代替 “https”。 

。 在 Available Software 对 话 框 中 ,选中 Developer Tools 边 上 的 复 选 框 并 单 击 
Next 按钮 。 

。 在 下 一 个 窗口 中 ,你 将 看 到 一 系列 可 下 载 的 工具 。 单 击 Next 按钮 。 

。 阅读 并 接受 协议 , 单 击 Finish 按钮 。 

。 安装 完成 后 重启 Eclipse。 

2. 配置 ADT 插件 

。 选择 Window 一 Preferences…。 

。 在 左 侧 面板 中 选择 Android。 

。 在 主 面板 的 SDK Location 中 单 击 Browse… 按 钮 ,并 定位 到 你 所 下 载 的 SDK 
目录 。 

。 单 击 Apply 按钮 ,然后 单 击 OK 按钮 。 

3. 下 载 本 地 并 手动 安装 

如 果 无 法 使 用 Eclipse 下 载 ADT 插件 ,可 以 下 载 ADT 的 zip 文件 到 本 地 并 手动 

。 下载 当 前 的 ADT 插件 zip 文件 。 

。 完成 上 述 安 装 的 第 1 步 和 第 2 步 。 

。 在 Add Site 对 话 框 中 , 单 击 Archive 按钮 。 
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。 选择 已 下 载 的 zip 文件 。 

。 输入 一 个 名 称 , 如 Android Plugin。 
。 单 击 OK 按钮 。 

。 完成 上 述 安装 的 剩余 步骤 。 
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如 果 在 Android 应 用 系统 中 需要 用 到 地 图 等 功能 ,还 需要 安装 Google Play Service 
SDK。Google Play Service SDK 由 Android SDK 管理 器 安装 。 
(1) 启动 SDK 管理 器 。 从 Eclipse 启动 Android 的 SDK 管理 器 ,如 图 1.6 所 示 。 


Android SDK 


SDK path: 
Packages 
Name | APIL Rev status 本 
"品目 Extras | | | 
Android Support Library | | 10 |¥ Update available: rev. 11 
@ Google AdMob Ads SDK 8 |Y Notinstalled 
Google Analytics SDK | 2 |¥ Notinstalled 


a Google cloud Messaging forAndroid Libron 3 | 净 Notinstalled 

@ Google Play APK Expansion Library 关 Not installed 

@ Google Play Billing Library | 

@a Google Play Licensing Library 

@ Google USB Driver 

@ Google Web Driver 

Intel x86 Emulator Accelerator (HAXM) 


2 

3 |$ Notinstalled 

2 | 晶 Notinstalled 

7 |¥ Not compatible with Linux 
2 | Notinstalled 

2 |¥ Not compatible with Linux 


Show: 国 Updates/New 图 Installed 门 Obsolete SelectNeworUpdates | Install1package... | 
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图 1.6 Android SDK Manager 界面 


(2) 滚动 到 软件 包 列 表 的 底部 ,选择 Extras 习 Google Play Service, 并 安装 它 。 

(3) 在 使 用 Google Play Service 相关 的 功能 时 ,将 目录 所 android-sdk-folder 二 / 
extras/google/ google_play_services/libproject/google-play-services_lib 复制 到 Android 
应 用 程序 项 目下 ,具体 的 操作 过 程 会 在 后 续 章 节 使 用 时 详细 说 明 。 


1.3 第 一 个 Android 应 用 程序 


在 完成 Android 开发 环境 的 安装 和 配置 后 ,就 可 以 使 用 Eclipse 开始 开发 Android 应 
用 程序 了 。 下 面 介绍 第 一 个 Android 应 用 程序 ,Hello Mobile World 的 开发 和 运行 过 程 ， 
它 的 功能 是 在 界面 上 显示 “您 好 ,移动 世界 ”的 字符 。 

第 一 次 编写 Android 应 用 程序 需要 完成 以 下 四 个 步骤 : 

(1) 创建 AVD。 

(2) 创建 一 个 新 的 Android 项 目 。 

(3) 创建 定义 用 户 界面 。 
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(4) 运行 应 用 程序 。 
131 创建 AD 


因为 Eclipse 运行 Android 应 用 程序 时 ,是 在 Android 仿真 器 中 运行 ,在 编写 和 运行 
Android 应 用 程序 之 前 ,第 一 步 必 须 先 创建 一 个 Android 虚拟 设备 (Android Virtual 
Device,AVD)。AVD 定义 了 系统 镜像 以 及 仿真 器 需要 的 设备 设置 ,模拟 了 真实 Android 
系统 下 的 环境 。 

具体 的 操作 步骤 如 下 : 

(1) 在 Eclipse 中 ,选择 Window 一 Android SDK and AVD Manager。 

(2) 在 左 侧 面板 中 选择 Virtual Devices 。 

(3) 单 击 New 按钮 ,出 现 Create new Android Virtual Device(AVD) 对 话 框 ,对 AVD 
的 名 称 、 软 件 环境 和 硬件 属性 进行 配置 ,如 图 1.7 所 示 。 


口 override the existing AVD with the same name 


[een ] (mat) 


图 1.7 配置 AVD 
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在 Name 输入 框 中 输入 新 的 AVD 的 名 称 , 如 my_avd; 

在 Target 下 拉 菜 单 中 ,选择 AVD 所 使 用 的 Android SDK 版 本 。 如 果 在 Android 
SDK 安装 过 程 中 安装 了 几 个 版 本 ,都 可 以 从 这 里 看 到 ; 

CPU 指示 的 是 模拟 器 运行 时 模拟 的 CPU 型 号 ; 

SD Card 的 Size 输入 框 可 以 设 定 模拟 器 的 内 存 大 小 ,例如 设置 为 512MB; 

。 快照 Snapshot 模拟 器 的 皮肤 Skin 和 硬件 配置 Hardware 可 以 采用 默认 的 值 。 

配置 完成 后 , 单 击 对 话 框 下 方 的 Create AVD 按钮 ,完成 AVD 的 创建 过 程 。 

(4) 选择 一 个 目标 。 目 标 即 想 在 仿真 器 上 运行 的 平台 (Android SDK 的 版 本 号 ,如 
2.1)。 可 以 忽略 剩 下 的 输入 框 。 

(5) 单 击 Create AVD 按钮 ,这 时 从 左面 列表 里 ,就 可 以 看 到 创建 好 的 AVD。 

AVD 前 面 的 绿色 的 勾 ,表示 这 个 AVD 可 以 正常 运行 ,通过 右边 的 按钮 ,可 以 对 创建 
好 的 AVD 进行 编辑 \ 修 复 等 操作 ,Start 按钮 可 以 直接 启动 AVD。 可 以 创建 多 个 配置 不 
同 的 AVD, 在 列表 中 单 击 选择 后 ,直接 用 Start 按钮 运行 这 个 AVD。 

(6) 关闭 AVD Manager 对 话 框 , 回 到 Eclipse 主 界面 。 
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AVD 创建 完成 后 ,可 以 按照 创建 Eclipse 的 Java 或 Web 项 目 等 类 似 的 步骤 ,在 
Eclipse 中 ,创建 一 个 Android 项 目 。 

具体 的 操作 步 又 如 下 : 

(1) 在 Eclipse 中 ,选择 File>New 一 Project。 如 果 已 经 成 功 安装 ADT 搬 件 ,对 话 框 
中 将 出 现 一 个 名 为 Android 的 文件 夹 ,该 文件 夹 中 包含 Android Project( 在 创建 了 一 个 或 
多 个 Android 项 目 后 ,条 目 Android XML File 也 将 变 成 可 用 状态 )。 

(2) 选择 Android Project, 然 后 单 击 Next 按钮 。 

(3) 在 对 话 框 中 填写 如 下 内 容 : 


Project name: HelloWorld 

Application name: Hello, Mobile World! 

Package name: cn.edu.uibemc.sample 戈 者 你 自己 的 私有 命名 空间 ) 

Create Rctivity: HelloWorldActivity 

。 Project name 是 项 目 名 称 ,Eclipse 在 工作 区 中 创建 与 项 目 名 相同 的 目录 名 ,该 目 
录 中 包含 项 目 文件 。 

。 Application name 是 应 用 程序 的 名 称 , 应 用 程序 的 标题 。 这 个 名 称 将 作为 应 用 程 
序 的 标题 ,显示 在 Android 设备 上 ,这 是 给 用 户 的 提示 信息 。 这 里 给 此 应 用 取 名 
为 Hello Mobile World。 

。 Package name 是 Java 包 的 名 称 ,这 与 标准 Java 语言 中 包 的 概念 相同 。 在 此 包 
中 ,将 生成 主 Activity。 这 个 应 用 的 其 他 类 也 放 在 cn. edu. uibe. mc. sample 包 及 
其 子 包 中 。 

。 Create Activity 是 主 Activity 的 类 名 称 , 是 Activity 类 的 子 类 。 一 个 Activity 就 
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是 一 个 普通 的 类 , 它 能 创建 一 个 Android 用 户 界面 ,当然 这 并 不 是 必需 的 。 由 于 
有 复 选 框 ,因此 创建 Activity 是 可 选 的 ,但 是 Activity 通常 被 作为 一 个 应 用 程序 
的 基础 。 这 里 输入 类 名 称 HelloWorldActivity。 

Min SDK Version 值 定义 了 应 用 程序 所 需要 的 最 小 API 等 级 。 更 多 信息 请 参考 
Android API Levels。 

Use default location 复 选 框 允许 改变 即将 生成 的 项 目 文件 在 磁盘 上 的 路 径 。 
Build Target 是 应 用 程序 将 被 编译 的 平台 目标 (基于 Min SDK Version, 该 值 将 被 
自动 设置 ) 注 意 : 假如 已 经 选择 了 Android 1. 1 平台 作为 Build Target。 那 么 意味 
着 应 用 程序 将 在 Android 1. 1 平台 库 基 础 上 进行 编译 。 如 果 之 前 创建 的 AVD 是 
运行 在 Android 1.5 平台 上 的 。Android 应 用 程序 是 向 前 兼容 的 ,因此 在 1.1 平 
台 库 上 构建 的 应 用 程序 可 以 正常 运行 在 1.5 平台 上 ,反之 则 不 行 。 

(4) 单 击 Finish 按钮 。 

完成 Android 项 目的 创建 之 后 ,下 一 步 就 可 以 在 这 个 项 目 中 对 Android 用 户 界面 进 
行 定义 和 修改 。 

从 左面 的 Package Explorer 视图 中 ,可 以 看 到 前 面 所 建 的 项 目 , 单 击 打开 ,查看 src 
目录 下 cn. edu. uibe. mc. sample 的 Java 源 程 序 HelloWorldActivity. java。 打 开 这 个 
Java 源 文件 ,其 内 容 如 代码 1. 1 所 示 。 

代码 1.1 HelloWorldActivity. java 


jimport android.app.Rctivityy 
import android.os.Bundle; 


Public class HellcWorldnctivity extends Activity { 
xx Called when the activity is first createdx / 
@ Override 
Public void onCreate (Bundle savedInstanoeState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.laycut .main) 


1 


从 代码 1. 1 中 可 以 看 出 , HelloWorldActivity 是 Activity 的 子 类 。Activity 是 
Android 系统 中 用 于 实现 用 户 图 形 界面 的 类 。 

public void onCreate() 方 法 是 Activity 所 定义 的 方法 , 当 Activity 启动 时 由 Android 
系统 调用 ,会 首先 在 这 个 方法 中 执行 初始 化 和 用 户 界 面 设置 工作 。 

一 个 Activity 并 不 一 定 都 有 用 户 界面 ,但 通常 都 会 有 。Activity 概念 可 以 参照 
Applet 来 理解 。 
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如 果 要 在 Android 界面 上 显示 “您 好 ,移动 世界 ”, 需要 对 自动 生成 的 
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HelloWorldActivity. java 代码 进行 修改 ,在 onCreate 方法 中 添加 显示 字符 串 的 组 件 , 并 
设置 其 显示 出 来 , 见 代码 1. 2。 
代码 1.2 修改 后 的 HelloWorldActivity. java 


import android.app.Activity; 
jimport android.o0s.Bundle; 


Public class HelloWorldActivity extends Activity { 

fx*Called when the activity is first createdx / 

@ Overrige 

Public void onCreate (Bundle savedInstanoeState) { 
Super.onCreate (savedInstanoeState); 
TextView ty new TextView (this); 
tv.setText ("您 好 ,移动 世界 1"); 
SetContentView (tv); 


} 


在 Java 程序 导入 包 的 时 候 , 可 以 直接 使 用 快捷 键 Ctrl 十 Shift 十 O。 

在 代码 1.2 里 定义 了 一 个 文本 显示 框 TextView 的 对 象 tv, 将 TextView 类 对 象 作 为 
Activity 用 户 界 面 显示 的 内 容 , 传 给 setContentView() 方 法 。Activity 通过 调用 
setContentView(tv) ,把 tv 的 内 容 显示 出 来 。 如 果 Activity 不 调用 setContentView() 方 

法 , 则 不 会 ee 1 界面 ,系统 会 显示 一 片 空白 。 

下 一 步 , 就 是 运行 应 用 程序 了 。 
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在 仿真 器 中 运行 HelloWorldActivity 步骤 如 下 。 

(1) 在 Eclipse 中 ,选择 Run 一 Run。 

(2) 选择 Android Application ,Eclipse 插件 自动 为 应 用 程序 创建 一 个 新 的 运行 配置 
并 启动 Android 仿真 器 。 

(3) 当 仿真 器 启动 后 ,Eclipse 插件 将 安装 应 用 程序 并 运行 默认 的 Activity。 

启动 仿真 器 后 ,可 以 看 到 一 个 手机 的 界面 。 左 面 是 显示 屏幕 ,右边 是 手机 的 键盘 按 
键 ,通过 键盘 的 按钮 可 以 直接 对 仿真 器 进行 操作 。 

这 时 需要 真正 的 耐心 等 待 运行 结果 。 一 般 来 说 ,第 一 次 在 仿真 器 上 运行 Android 应 
用 程序 需要 花 更 长 的 时 间 。 上 有 具体 的 时 间 与 机 器 性 能 和 配置 有 关 。 

如 果 5 一 6 分 钟 都 只 看 到 仿真 器 上 的 Logo 在 闪烁 ,不 要 着 急 ,去 喝 一 杯 茶 或 咖啡 休 

一 下 ,过 一 会 儿 再 来 。 

图 1.8 是 修改 后 HelloWorldActivity. java 的 运行 结果 。 上 面 一 行 ,绿色 小 图 标 是 这 
个 应 用 程序 的 Logo, 文 字 是 前 面 定 义 的 应 用 程序 名 ;下 面 一 行 是 TextView 对 象 显示 的 
内 容 。 
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1.8 ”HelloWorldActivity. java 的 运行 结果 


单 击 右面 键盘 上 的 返回 键 ,返回 Android 系统 的 主 界面 ,如 图 1.9 所 示 。 


WIDGETS 


图 1.9 Android 系统 主 界面 
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这 里 是 Android 系统 的 主 界面 ,除了 刚才 编写 的 这 个 程序 外 ,还 有 一 些 其 他 的 程序 ， 
例如 时 钟 \ 日 历 、 照 相机、 图片 等 ,这 些 程序 是 创建 Android Project 时 ,由 Android SDK 加 
载 的 Demo 程序 。 

单 击 任意 一 个 Logo, 比 如 API Demos 一 Animation, 启 动 Android 系统 的 应 用 程序 ， 
查看 一 下 结果 。 

单 击 右面 键盘 上 的 Home 键 , 回 到 主 界面 , 单 击 图 1. 9 中 左下 角 的 小 机 器 人 ,这 是 应 
用 程序 Logo, 可 以 重新 看 到 图 1. 8 的 显示 结果 。 

刚才 完成 这 个 “Hello Mobile World” 的 界面 ,图 中 灰色 条 显示 的 “Hello，Mobile 
World” 就 是 应 用 程序 标题 ,该 字符 串 定义 在 res/values /strings. xml 文件 中 并 被 
AndroidManifest. xml 文件 所 引用 ,标题 之 下 的 文本 就 是 Java 源 程序 在 TextView 对 象 
中 设置 的 。 

这 里 使 用 的 是 “编程 式 ” 的 用 户 布局 方式 ,也 就 是 使 用 Java 程序 来 定义 用 户 界面 上 的 
View 图 形 组 件 。 这 种 布局 方式 有 很 大 的 缺点 ,比如 一 些小 的 布局 变化 有 可 能 导致 大 的 源 
码 修改 ,编写 程序 时 也 很 容易 忘记 将 多 个 View 链接 在 一 起 ,这 种 方式 有 时 是 很 脆弱 的 ， 
一 些小 的 布局 变化 都 有 可 能 导致 大 的 源码 修改 。 

以 上 就 是 构建 Hello,Mobile World” 应 用 程序 的 过 程 ,但 这 不 是 Android 系统 推荐 
的 设计 用 户 界面 的 方法 ,Android 提供 了 一 个 可 选 的 用 户 界面 构建 模型 , 即 基 于 XML 的 
布局 文件 的 用 户 界面 构建 模型 。 

下 面 看 看 如 何 使 用 XML 布局 文件 来 构建 用 户 界面 。 
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刚才 完成 的 "Hello,Mobile World” 应 用 程序 使 用 的 是 “编程 式 "的 用 户 布局 方式 。 使 
用 这 种 方式 是 直接 在 源 代码 中 构建 应 用 程序 的 用 户 界 面 。 这 种 方式 对 于 界面 的 开发 是 很 
不 方便 的 ,因为 一 些小 的 布局 变化 都 有 可 能 导致 源码 的 修改 ,并 且 需 要 重新 编译 ,所 以 经 
常 需要 使 用 MVC 开发 模式 。Android 也 设计 了 一 套 MVC 开发 模式 ,其 提供 了 一 个 基于 
XML 的 布局 文件 来 定义 用 户 界面 。 

Android 系统 推荐 使 用 XML Android 来 设计 用 户 界面 。XML 布局 文件 都 位 于 应 用 
程序 的 res/layout/ 目 录 中 。res 是 resources 的 缩写 ,该 目录 中 包含 应 用 程序 所 需要 的 所 
有 非 代 码 资源 。 除 了 布局 文件 之 外 :资源 还 包括 图 片 ,声音 以 及 本 地 字符 串 。 

在 Package Explorer 中 ,展开 /res/layout/ 文 件 夹 。 在 创建 Android Project 时 ， 
Eclipse 插件 自动 创建 一 个 布局 文件 : main. xml。 在 前 面 修改 完成 的 "Hello, Mobile 
World” 应 用 中 ,该 文件 被 忽略 了 ,而 以 编程 方式 创建 了 布局 。 这 是 为 了 介绍 更 多 关于 
Android 框架 知识 。 通 常情 况 下 ,建议 使 用 XML 文件 布局 而 不 是 硬 编码 。 

双击 打开 main. xml 文件 , 单 击 Java 视图 里 的 main. xml 小 标签 ,XML 文件 内 容 如 
代码 1. 3 所 示 。 
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代码 1.3 main. xml 


< Zuml version= "1.0" encoding= "utf— 8"2> 
< LinearTayout xmlns:android= "http://schemas.android.oqvVapk/res/android" 
android:layout widthr "fill parent" 
android:layout _ height= "fil1 Parent" 
android:orientation= "vertical"> 


< TextView 
android:layout width= "fill parent" 
android: layout. height= "wrap oontent" 
android:text= "@ string/hello"/> 


< /LinearLayout> 


一 个 Android XML 布局 文件 的 总 体 结构 比较 简单 : 就 是 一 棵 XML 元 素 的 树 , 树 中 
的 每 个 节点 都 使 用 View 类 的 类 名 作为 元 素 名 称 , 每 一 个 元 素 都 对 应 一 个 用 户 图 形 界面 
中 的 组 件 , 在 代码 1. 3 中 只 有 一 个 元 素 TextView。 

XML 布局 中 的 元 素 可 以 是 任何 View 子 类 ,包括 自 定 义 的 View 类 。 与 “编程 ”布局 
方式 相 比 ,XML 布局 使 用 了 更 简单 的 结构 和 语法 ,能够 快速 构建 用 户 界 面 。 这 种 模型 的 
灵感 源 于 Web 开发 模型 ,使 用 这 种 方式 ,把 应 用 程序 的 用 户 界 面 从 应 用 逻辑 中 分 离 了 出 
来 。 我 们 来 仔细 看 一 下 代码 1. 3 内 容 , 初 步 了 解 XML 布局 的 语法 格式 。 

二 ?xml version 一 "1.0" encoding 一 "utf-8"? 过 是 版 本 和 采用 的 编码 标准 ,这 是 布局 
类 型 定义 。 在 这 个 XML 布局 文件 中 ,只 定义 了 一 个 View 元 素 : TextView, 它 有 4 个 
XML 属性 ,分 别 在 下 面 进行 了 定义 : 

(1) xmlns:android: 这 是 XML 命名 空间 声明 , 它 告 诉 Android 工具 应 用 程序 将 要 
引用 在 Android 命名 空间 中 定义 的 普通 属性 。 在 每 个 Android 布局 文件 的 最 外 层 标签 中 
必须 包含 这 个 属性 。 

(2) android:layout_width: 定义 了 TextView 在 屏幕 上 会 占用 的 可 用 宽度 。 在 本 例 
中 ,由 于 只 有 一 个 View, 这 里 设置 它 占据 整个 屏幕 ,因此 定义 了 值 *fill_parent”。 

(3) android:layout_height: 定义 了 TextView 在 屏幕 上 会 占用 的 可 用 高 度 。 属 性 值 
和 “android:layout_width” 相 似 。 

(4) android:text: 设置 了 TextView 将 要 显示 的 值 。 在 本 例 中 ,使 用 了 字符 串 资 源 
而 不 是 直接 给 出 了 字符 串 值 。 字 符 串 定义 在 res/values/strings. xml 文件 中 。 这 是 一 种 
推荐 的 方式 ,因为 这 可 以 使 应 用 程序 能 够 很 好 的 本 地 化 ,而 不 需要 改变 布局 文件 。 

下 面 修改 一 下 程序 代码 ,使 这 个 Hello 程序 采用 XML 布局 文件 定义 用 户 界 面 。 

1. 定义 XML 布局 文件 

在 Eclipse 的 Package Explorer 中 ,展开 /res/layout/ 文 件 夹 并 打开 main. xml, 查 看 
里 面 的 组 件 定义 是 否 符合 要 求 , 这 里 还 是 沿用 原来 的 main. xml。 

如 果 在 项 目 中 有 多 个 Activity, 需 要 使 用 不 同 的 界面 布局 ,可 以 在 /res/layout/ 目 录 
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下 创建 新 的 布局 文件 。 

2. 在 资源 文件 string. xml 中 定义 字符 串 变量 的 值 

进入 res/values/ 文 件 夹 ,打开 string. xml, 这 是 用 户 界面 保存 所 有 默认 字符 串 的 文 
件 。 前 面 使 用 Eclipse 工具 创建 Android 项 目 时 ,ADT 已 经 根据 创建 Android project 时 
输入 的 信息 , 设 定好 两 个 字符 串 变 量 hello 和 app_name 的 值 ,分 别 为 “你 好 ,移动 世界 !1” 
和 “Hello,Mobile World !”, 见 代码 1. 4。 

代码 1.4 string. xml 


<? xml version= "1.0" encoding= "utf- 8"? > 
< resources> 


< string name= "hello"> 你 好 ,移动 世界 !< /string> 
< string name= "app name"> Hello, Mcbile World!< /string> 


< /resources> 


3. 修改 HelloWorldActivity. java 文件 
恢复 HelloWorldActivity. java 原来 没有 定义 TextView 时 的 代码 。 


setContentView (R.layout .main); 


原来 传 给 setContentView ( ) 方 法 的 是 一 个 View 对 象 ,现在 传递 的 是 标识 为 
R. layout. main 的 布局 资源 引用 。R. layout. main 实际 上 是 一 个 编译 好 的 对 象 , 也 就 是 在 
/res/layout/main. xml 文件 中 的 布局 定义 。Eclipse 插件 自动 在 项 目的 R. java 类 中 创建 
了 这 个 引用 。 
重新 运行 HelloWorldActivity. java 文件 ,查看 AVD 上 的 结果 。 
代码 1.5 HelloWorldActivity. java 


Public class HelloWorldActivity extends Activity { 
x*Called when the activity is first created* / 
@ Override 
Public void onCreate (Bundle savedInstanceState) { 
Super.anCreate (savedInstanceState) 7 
setContentView (R.layout.main) 


} 


运行 代码 1.5 后 ,显示 的 结果 与 前 面 使 用 编程 式 布局 定义 没有 什么 不 同 。 下 面 修改 
一 下 main. xml 文件 ,添加 一 个 TextView 定义 ,看 看 main. xml 如 何 对 应 用 程序 布局 的 


影响 。 
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4. 修改 main. xml 文件 
先 把 XML 文件 中 原来 的 TextView 定义 复制 一 份 , 放 在 它 的 下 面 。 由 于 添加 一 个 
TextView, 要 识别 不 同 的 TextView 对 象 ,因此 需要 添加 一 条 语句 。 


android:id= "@ + id/textviewl™" 

android:id 这 个 属性 给 TextView 元 素 分 配 了 一 个 唯一 标识 textview1。 可 以 使 用 这 
个 标识 在 Java 源 代码 或 者 其 他 XML 资源 声明 中 引用 这 个 对 象 。 给 这 两 个 TextView 的 
标识 分 别 设置 为 textviewl 和 textview2, 见 代码 1. 6。 

代码 1.6 修改 后 的 main. xml 


< ?ml version= "] .0" enooding= "utf- 8"2> 

< LinearTayout xmlns:android= "http://schemas.android.cam/apk/res/android" 
android:layout width= "fill parent" 

android:layout height= "fill parent" 

android:orientation= "vertical"> 


< TextView 
android:id= "@ + id/textviewl" 
android: layout width= "fill parent" 
android: layout height= "wrap content" 
android:text= "@ string/hello"/> 
< TextView 
android:id= "@ + id/textview2" 
android: layout width= "fill parent" 
android: layout height= "wrap coontent" 
android:text= "@ string/hello"/> 
< /LinearIayout> 
保存 main. xml 文件 。 再 次 运行 HelloWorldActivity. java 文件 ,查看 AVD 界面 , 结 
果 显 示 了 两 行 字符 ,每 一 行 是 一 个 TextView。 
5. 修改 资源 文件 
进入 res/values/ 文 件 夹 , 打 开 strings. xml, 这 是 Android 为 用 户 界面 保存 所 有 默认 
字符 串 的 地 方 , 找 到 string 的 定义 ,这 里 的 值 就 是 显示 在 屏幕 上 的 字符 串 。 
在 string 下 面 定 义 一 个 新 的 字符 串 newhello, 赋 值 为 “你 好 , Android 移动 商务 
平台 !。 


保存 strings. xml 文件 。 
< string name= "newhello"> 你 好 ,Android 移 动 商务 平台 !< /string> 


6. 修改 main. xml 文件 
修改 textview1 的 text 为 newhello, 让 textview2 显示 newhello 定义 的 字符 串 ,保存 
main. xml 文件 。 
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再 次 运行 HelloWorldActivity. java 文件 ,AVD 上 的 结果 显示 了 三 行 字符 “Hello， 
Mobile World”“ 你 好 ,移动 世界 1”" 和 “你 好 ,Android 移动 商务 平台 !”。 

7. 查看 apk 文件 

到 这 里 ,完成 了 第 一 个 Android 应 用 程序 的 开发 和 运行 ,也 得 到 了 可 以 在 真正 
Android 系统 上 运行 的 apk 文件 。 
展开 hello project 中 的 bin 目录 ,可 以 看 到 hello. apk 文件 ,在 手机 上 像 安装 其 他 
Android 程序 一 样 安装 hello. apk 文件 后 ,在 Android 的 应 用 程序 目录 下 找到 hello 的 项 
目 图 标 就 可 以 运行 了 。 

在 仿真 器 上 调试 通过 后 ,apk 文件 发 布 到 支持 相应 Android SDK 版 本 的 手机 上 可 以 
直接 运行 ,不 必 再 针对 具体 的 型 号 进行 调试 ,开发 者 只 需要 做 到 这 一 步 就 完成 了 Android 
应 用 程序 的 开发 。 
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在 Eclipse 环境 的 ADT 中 完成 Android 应 用 程序 调试 后 ,就 可 以 发 布 到 手机 上 ,并 
在 手机 上 进行 测试 。 

要 在 手机 上 运行 应 用 程序 ,需要 将 手机 和 Eclipse 连接 起 来 ,将 Android 应 用 程序 的 
apk 文件 装载 到 手机 上 ,这 需要 在 计算 机 上 安装 手机 的 USB 驱动 。 

1. 安装 USB 驱动 

从 官方 网 站 http://developer. android. com/sdk/win-usb. html 下 载 Android 手机 
USB 驱动 。 如 果 没 有 直接 的 驱动 ,到 手机 厂商 相应 站 点 下 载 。 手 机 与 手机 公司 网 站 的 对 
应 列表 可 以 从 链接 http://developer. android. com/sdk/oem-usb. html 上 找到 。 

2. 设置 Android 手机 为 USB 调试 模式 

使 用 USB 数据 线 将 手机 和 计算 机 连接 “menu 一 设置 一 应 用 程序 一 开发 ”选择 
“USB 调试 ”。 

3. 通过 Eclipse 上 真 机 测试 

安装 好 手机 的 usb 驱动 后 ,在 Eclipse 中 : 右键 一 run as 一 run configurations 一 
target, 去 除 虚拟 机 选择 。 在 Eclipse 中 ,选择 Ruan 一 Run, 在 真 机 上 运行 Android 应 用 程 
序 , 进 行 真 机 测试 。 

4. 发 布 

完成 真 机 测试 后 ,就 可 以 进行 应 用 程序 到 真 机 的 发 布 。 

Android 应 用 程序 在 编译 成 功 后 ,Project 文件 夹 下 bin 文件 夹 中 会 生成 XX Xx X. 
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apk 文件 ,这 就 是 可 执行 的 Android 程序 ,可 以 用 任何 手机 同步 工具 像 安 装 其 他 Android 
程序 一 样 安装 自己 的 项 目 。 


1.4 Android Project 结构 分 析 


上 一 节 建 了 第 一 个 Android 项 目 , 下 面 就 以 这 个 应 用 为 基础 进行 目录 结构 概述 ,如 图 
1. 10 所 示 。 


才 Package Explorer 253 


日 乞 | 多 
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图 1.10 Android 项 目 结构 图 
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任何 Android 项 目 创建 后 ,都 会 自动 生成 如 图 1. 10 所 示 的 目录 。 下 面 简单 介绍 这 些 
目录 的 所 包含 的 内 容 和 作用 。 

(1) src 文件 夹 : 与 一 般 的 Java 项 目 一 样 , src 文件 夹 是 项 目的 所 有 包 及 源 文件 
(.java) 。 


(2) gen 文件 夹 : 该 目录 下 的 所 有 文件 都 不 是 由 开发 人 员 创 建 的 ,而 是 由 ADT 自动 
生成 的 。 其 中 ,R. java 文件 是 定义 该 项 目 所 有 的 资源 文件 的 索引 文件 ,该 文件 是 只 读 模 
式 。R. java 文件 中 默认 有 attr drawable .layout string 四 个 静态 内 部 类 ,其 内 容 见 代 
码 1.7。 
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代码 1.7 R.java 


piblic final class R { 
Public static final class attr { 
8 
Public static final class drawable { 
Public static final int ic launcher= 0x7f020000; 
» 
piblic static final class layout { 
piblic static final int main= 0x7f030000; 
} 
Public static final class string { 
piblic static final int app name= Qx7f040001; 
piblic static final int hello= 0x7f040000; 


} 


(3) Android 2.1: 包含 了 android.jar 包 ,是 Android SDK 中 提供 Android platforms 
API 的 基本 类 包 ,Android 库 、 系 统 镜像 .样本 代码 、 仿 真 skins (界面 ) 以 及 指定 版 本 的 工 
具 。 这 是 Android 应 用 程序 运行 的 基础 支持 。 

(4) assets 文件 夹 : Android 系统 为 每 个 新 设计 的 程序 提供 了 /assets 目录 ,这 个 目录 
保存 的 文件 可 以 打包 在 程序 里 。/res 和 /assets 的 不 同 点 是 ,android 不 为 /assets 下 的 文 
件 生成 ID。 如 果 使 用 /assets 下 的 文件 ,需要 指定 文件 的 路 径 和 文件 名 。 

(5) bin 文件 夹 : 是 程序 自动 生成 的 应 用 文件 夹 ,用 来 存放 项 目 中 应 用 程序 生成 的 
apk 文件 。 

(6) res 文件 夹 : 该 目录 为 资源 目录 ,而 res 就 是 resource 的 缩写 。 该 目录 用 来 存放 
图 标 、 界 面 文件 和 应 用 中 用 到 的 文字 信息 。 这 个 目录 中 又 有 专门 的 子 目 录 存 放 特 定 资源 ， 
其 中 : 


。 res/: 该 目录 下 的 三 个 drawable 文件 夹 将 图 标 按 分 辨 率 高 低 来 存放 入 不 同 的 目 
录 中 ,其 中 drawable-hdpi 用 来 存放 高 分 辩 率 图 标 ;drawable-mdpi 用 来 存放 中 等 
分 辩 率 图 标 ;drawable-ldpi 用 来 存放 低 分 辩 率 图 标 。 

res/values/: 该 目录 用 来 存放 strings. xml 等 类 似 于 定义 属性 值 的 资源 文件 。 
strings. xml 用 来 定义 字符 串 和 数值 ,HelloWorld 项 目 中 的 string. xml 文件 内 容 
如 下 : 


< ?ml version= "1 .0" encoding= "utf- 8> 

< resouroes> 
< string name= "hello"> Hello,World World, HelloWorldactivity!< /string> 
< string name= "app_namen> HelloWorldk /string> 

< /resources> 


其 中 ,string 标签 声明 一 个 字符 串 ,name 属性 指定 其 引用 名 。 把 应 用 中 出 现 的 文 
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字 单 独 存放 在 string. xml 文中 的 原因 有 二 : 一 是 为 了 国际 化 ;二 是 为 了 减少 应 用 
体积 ,降低 数据 宛 余 。 

。 res/layout/: 该 目录 用 来 存放 布局 文件 。main. xml 布局 文件 是 Android 项 目 生 
成 时 自动 产生 的 主 界面 布局 文件 ,程序 员 可 以 根据 自己 的 界面 设计 ,定义 命名 自 
己 的 布局 文件 。 

(7) 根 目录 下 的 三 个 重要 文件 : 

。 AndroidManifest. xml 文件 : 包含 了 该 Android 项 目 中 所 有 使 用 的 Activity、 
Service、Receiver 等 组 件 的 声明 。 

。 default. properties 文件 : 记录 项 目 中 所 需要 的 环境 信息 ,比如 Android 的 版 
本 等 。 

。 proguard. cfg 文件 : 混淆 代码 的 脚本 配置 文件 。 
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AndroidManifest. xml 文件 是 当前 Android 项 目的 功能 清单 文件 ,该 文件 列 出 了 应 
用 中 所 使 用 的 所 有 组 件 。 只 有 在 AndroidManifest. xml 文件 中 声明 了 的 组 件 ,才能 够 在 
项 目 启 动 时 运行 。 在 后 面 章节 的 叙述 中 ,有 时 简称 其 为 manifest 文件 。 

前 面 所 建 HelloWorld 项 目的 AndroidMainfest. xml 文件 的 内 容 如 代码 1. 8 所 示 。 

代码 1.8 AndroidManifest. xml 
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AndroidManifest. xml 文件 中 采用 了 特定 的 标记 ,来 描述 Android 项 目 中 应 用 程序 
或 组 件 的 名 称 、 特 性 等 。 下 面 是 一 些 主要 标记 的 说 明 。 
。 一 manifest 记 ; 根 节点 ,描述 了 package 中 所 有 的 内 容 。 


. 


xmlns:android: 包含 命名 空间 的 说 明 ,该 命名 空间 使 得 Android 中 各 种 标准 属性 
能 在 文件 中 使 用 。 

package: 声明 应 用 程序 包 。 

android:versionCode: 该 应 用 程序 版 本 代号 。 

android:versionName: 该 应 用 程序 版 本 名 称 。 

uses-sdk: 该 应 用 程序 所 使 用 的 SDK 版 本 。 

二 application 记 : 包含 package 中 application 级 别 组 件 声 明 的 根 节点 。 此 元 素 也 
可 包含 application 的 一 些 全 局 和 默认 的 属性 ,如 标签 图标、 主题 ,必要 的 权限 等 。 
一 个 manifest 中 至 多 包含 一 个 此 元 素 。 

android:icon: 应 用 程序 图 标 。 

android:label: 应 用 程序 名 。 

Activity: Activity 是 用 户 打开 的 一 个 应 用 程序 的 初始 页 面 , 大 部 分 被 使 用 到 的 其 
他 页 面 也 由 不 同 的 Activity 所 实现 。 每 个 Activity 必须 有 一 个 二 Activity 二 标记 
对 应 ,无论 它 给 外 部 使 用 或 是 只 用 于 自己 的 package 中 。 为 了 支持 运行 时 查找 
Activity, 可 包含 一 个 或 多 个 二 intent-filter 二 元 素来 描述 Activity 所 支持 的 操作 。 
android:name: 应 用 程序 默认 启动 的 Activity。 

intent-filter: 声明 了 指定 的 一 组 组 件 支持 的 Intent 值 ,从 而 形式 了 IntentFilter。 
除了 能 在 此 元 素 下 指定 不 同类 型 的 值 ,属性 也 能 放 在 这 里 来 描述 一 个 操作 所 需 的 
唯一 标签 .图标 和 其 他 信息 。 

action: 组 件 支 持 的 Intent action。 

category: 组 件 支持 的 Intent Category。 这 里 指定 了 应 用 程序 默认 启动 的 
Activity。 


在 所 有 的 元 素 中 只 有 所 manifest 二 和 二 application 二 是 必需 的 , 且 只 能 出 现 一 次 。 如 
果 一 个 元 素 包 含 其 他 子 元 素 , 必 须 通 过 子 元 素 的 属性 来 设置 其 值 。 处 于 同一 层次 的 元 素 ， 
这 些 元 素 的 说 明 是 没有 顺序 的 。 

在 文件 的 树 中 ,最 外 层 的 二 manifest 二 中 包含 了 包 名 如 package 一 "cn. androidlover 
. demo" ,软件 的 版 本 号 android: versionCode 王 "1" 以 及 android: versionName 一 "1.0" 的 


属性 。 


里 面 一 层 子 元素 一 application 过 分支 中 ,将 可 能 包含 Android 程序 的 四 大 基础 组 件 
Activity、Service、Content Provider 以 及 Receiver 中 任 一 类 型 的 对 象 。 如 果 在 应 用 程序 
中 添加 上 面 四 个 类 型 中 的 任 一 种 新 对 象 ,都 需要 在 AndroidManifest. xml 文件 中 添加 相 
应 节点 ,否则 运行 时 将 会 产生 异常 。 例 如 ,对 于 一 个 Activity 来 说 ,无 论 给 外 部 使 用 或 是 
只 用 于 自己 的 package 中 ,都 必须 要 一 个 二 activity 之 标记 对 应 进行 说 明 。 如 果 Activity 
没有 对 应 的 标记 ,就 不 能 运行 。 

AndroidManifest. xml 文件 中 各 元 素 以 及 它们 的 属性 都 是 可 选 的 ,但 即使 没有 在 文 
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件 中 显示 设置 ,它们 也 都 有 默认 的 设置 。 除 了 根 元 素 二 manifest 二 的 属性 ,所 有 其 他 元 素 
属性 的 名 字 都 是 以 “android: ”作为 前 级 的 。 

下 面 是 定义 AndroidManifest. xml 元 素 时 需要 注意 的 地 方 。 

(1) 定义 类 名 : 所 有 的 元 素 名 都 对 应 其 在 SDK 中 的 类 名 ,如 果 是 自己 定义 类 名 , 必 
须 包 含 类 的 数据 包 名 ;如 果 类 与 application 处 于 同一 数据 包 中 ,可 以 直接 简写 为 “. ”。 

(2) 多 数值 项 : 如 果 某 个 元 素 的 属性 有 超过 一 个 数值 ,这 个 元 素 必须 通过 重复 的 方 
式 来 说 明 这 个 属性 具有 多 个 数值 项 , 且 不 能 将 多 个 数值 项 一 次 性 说 明 在 一 个 属性 中 。 

(3) 资源 项 说 明 : 当 需 要 引用 某 个 资源 时 ,需要 按照 规范 的 格式 : @[package:] 
type:name。 例 如 二 activity android:icon 王 "@drawable/icon " … 二 。 

(4) 字符 串 值 : 类 似 于 其 他 语言 ,如 果 字 符 中 包含 字符 “\”, 则 必须 使 用 转 义 字 
符 “\\”。 

AndroidManifest. xml 文件 中 的 元 素 是 规定 的 ,不 能 加 入 自己 创建 的 元 素 和 属性 。 
下 面 是 按照 字母 顺序 排列 的 所 有 可 以 出 现在 AndroidManifest. xml 文件 里 的 元 素 , 它 们 
是 唯一 合法 的 元 素 。 


1.5 模 拟 器 


Android 系统 提供 了 一 个 模拟 器 来 模拟 ARM 核 的 移动 设备 。Android 的 模拟 器 是 
基于 开源 虚拟 机 项 目 QEMU 开发 的 ( 详 见 http://bellard. org/qemu/), 它 可 以 提供 一 个 
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虚拟 的 ARM 移动 设备 。Android 模拟 器 被 命名 为 goldfish。Android 模拟 器 所 对 应 的 源 
代码 主要 在 external/qemu 目录 下 。 如 果 需 要 将 Android 应 用 程序 移植 到 其 他 设备 上 ， 
熟悉 它 目前 所 针对 的 模拟 器 环境 可 以 提供 一 些 参 考 。 

Windows 和 Linux 都 具有 支持 的 Android 模拟 器 ,Google 还 提供 了 Eclipse 插件 ,可 
将 模拟 器 集成 到 Eclipse 的 IDE 环境 。 这 为 应 用 程序 的 开发 者 提供 了 很 多 开发 和 测试 时 
的 便利 。 当 然 , 从 命令 行 也 可 以 启动 Android 模拟 器 。 

Android 模拟 器 的 功能 非常 齐全 ,可 以 模拟 电话 本 、 通 话 等 功能 ,甚至 其 内 置 的 浏览 
器 和 Google Maps 都 可 以 联网 。 用 户 可 以 使 用 键盘 输入 , 单 击 模拟 器 按键 输入 ,甚至 还 
可 以 使 用 鼠标 单 击 、 拖 动 屏幕 进行 操作 。 但 是 模拟 器 和 真 机 还 是 有 所 不 同 , 这 些 不 同 主要 
包括 : 

(1) 不 支持 呼叫 和 接听 实际 来 电 , 但 可 以 通过 控制 台 模拟 电话 呼叫 。 

(2) 不 支持 USB 连接 。 

(3) 不 支持 相机 /视频 捕捉 。 

(4) 不 支持 音频 输入 (捕捉 ) ,但 支持 输出 ( 重 放 ) 。 

(5) 不 支持 扩展 耳机 。 

(6) 不 能 确定 连接 状态 。 

(7) 不 能 确定 电池 电量 水 平和 交流 充电 状态 。 

(8) 不 能 确定 SD 卡 的 插入 /弹出 。 

(9) 不 支持 蓝牙 。 

在 开发 以 及 测试 Android 应 用 程序 过 程 中 ,为 了 修改 .运行 和 测试 方便 ,一 般 都 在 
Android 模拟 器 上 安装 并 运行 应 用 程序 。 在 启动 模拟 器 时 , 既 可 以 从 命令 行 中 启动 ,把 模 
拟 器 作为 一 个 独立 的 应 用 程序 运行 ,也 可 以 将 模拟 器 作为 Eclipse 开发 环境 的 一 部 分 。 无 
论 哪 种 方式 ,在 使 用 模拟 器 的 功能 之 前 ,都 必须 要 创建 一 个 的 具有 具体 配置 的 虚拟 手机 ， 
配置 AVD, 以 及 所 需要 使 用 的 启动 选项 。 在 一 个 Android 模拟 器 中 ,可 以 创建 多 个 不 同 
配置 的 虚拟 手机 ,模拟 不 同 配置 的 手机 环境 。 在 运行 Android 应 用 程序 时 ,可 以 在 不 同 的 
AVD 上 测试 同一 个 应 用 程序 。 

从 命令 行 中 启动 Android 模拟 器 , 则 从 命令 行 窗口 进入 Android SDK 的 tools/ 目 录 ， 


emlator- avck avd name> 


此 命令 将 初始 化 模拟 器 并 加 载 AVD 配置 ,并 启动 模拟 器 窗口 。 

如 果 使 用 Eclipse 的 ADT 插件 启动 Android 模拟 器 , 则 在 Eclipse 中 运行 或 调试 
Android 应 用 程序 时 ,ADT 插件 将 自动 安装 应 用 程序 并 启动 模拟 器 。 在 Eclipse 中 模拟 
器 的 启动 选项 ,可 以 在 Run/Debug 对 话 框 的 Target 页 签 中 定义 。 当 模拟 器 运行 时 ,也 可 
以 发 送 控制 台 命 令 。 
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1.6 小 结 


本 章 简 单 介 绍 了 Android 的 概念 ,Android 系统 的 技术 框架 。 详 细 介 绍 了 Android 
在 Eclipse 上 开发 环境 搭建 的 具体 步骤 ,使 用 一 个 Hello 程序 说 明了 Android 应 用 程序 的 
开发 和 运行 过 程 ,着 重 介绍 了 AVD 的 概念 和 创建 过 程 。 最 后 ,对 Android 项 目 中 的 各 目 
录 和 重要 文件 进行 了 解释 。 
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设计 应 用 界面 


每 个 Android 客户 端 应 用 首先 面 对 的 就 是 界面 的 开发 。Android 系统 提供 了 丰富 界 
面 控件 。Android 提供 的 用 户 图 形 交互 界面 称 为 Activity。 本 章 主 要 介绍 Activity 的 基 
本 知识 和 使 用 方法 ,如 何在 Activity 上 实现 不 同 的 布局 ,如 何 理解 字符 串 、 图 片 等 资源 的 
使 用 。 


2.1 理解 Activity 


Activity 是 Android 的 四 大 基本 组 件 之 一 。 通 过 Activity, 用 户 可 以 与 移动 终端 进行 
交互 ,使 用 Android 应 用 程序 做 一 些 事情 ,如 拨打 电话 、 拍 照 ,发 送 电 子 邮 件 或 查看 地 图 
等 。Activity 也 可 以 看 作 是 一 个 特定 的 窗口 ,输入 框 、 按 钮 等 各 种 视图 组 件 能 够 按 需求 进 
行 不 同 的 排列 。 这 种 窗口 通常 填 满 整个 屏幕 ,但 可 能 会 小 于 屏幕 或 者 浮 在 其 他 窗口 之 上 ， 
例如 对 话 框 。 

所 有 的 Activity 都 是 从 Android 提供 的 类 Activity 继承 而 来 。 一 个 应 用 程序 通常 由 
多 个 Activity 组 成 ,这 些 Activity 之 间 可 以 实现 相互 调用 , 一 般 不 会 将 所 有 的 功能 在 一 
个 Activity 中 实现 。 而 用 户 是 通过 这 些 相 关联 的 Activity, 来 完成 移动 终端 设备 的 操 
作 。 在 应 用 程序 中 ,通常 指定 一 个 主 Activity, 它 是 应 用 程序 启动 时 ,首先 呈现 给 用 户 的 
界面 。 

在 第 1 章 编写 第 一 个 Android 应 用 程序 显示 “Hello, Mobile World!" 时 ,用 到 了 
Activity。 下 面 来 复习 一 个 简单 的 Activity 创建 和 声明 过 程 ,从 组 件 的 角度 来 学 习 
Activity 程序 的 编写 。 

要 让 一 个 Activity 在 Android 应 用 程序 中 可 运行 ,必须 要 实现 两 个 任务 : 

(1) 命名 并 定义 一 个 Activity 的 子 类 。 

(2) 在 此 Android 应 用 程序 项 目 中 声明 这 个 Activity。 
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要 定义 一 个 用 户 界面 Activity ,必须 定义 一 个 子 类 来 继承 Activity。 在 Android 定义 
Activity 组 件 时 ,针对 用 户 界面 的 不 同 状态 变化 ,为 其 定义 了 一 系列 不 同 的 回调 方法 。 例 
如 用 户 界面 创建 改变 ,恢复 或 销毁 的 动作 ,都 对 应 Activity 中 不 同 的 回调 方法 。 所 谓 回 
调 方法 ,就 是 在 Activity 状态 变化 时 ,Android 系统 会 自动 调用 在 Activity 中 预先 定义 的 
对 应 方法 。 因 为 是 系统 反 向 调用 子 类 中 定义 方法 ,实现 其 功能 ,所 以 称 为 回调 。 因 此 定义 
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子 类 时 ,可 以 在 回调 方法 中 定义 需要 的 功能 ,系统 就 可 以 在 用 户 界面 状态 变化 时 ,调用 应 
用 程序 中 Activity 的 对 应 回调 方法 来 实现 其 功能 。 例 如 , 某 个 Activity 需要 在 界面 恢复 
时 ,重新 读 取 数 据 库 的 信息 ,就 可 以 在 此 Activity 的 onResume() 回 调 方法 中 定义 重新 读 
取 数 据 库 的 操作 。 这 样 , 当 这 个 Activity 界面 恢复 时 ,系统 就 会 自动 调用 它 的 onResume()， 
运行 里 面 定义 的 代码 ,实现 其 功能 。 

在 Activity 的 回调 方法 中 ,有 两 个 最 重要 的 回调 方法 onCreate() 和 onPause()。 

(1) onCreate(): 这 是 在 系统 创建 Activity 时 ,第 一 个 调用 这 个 方法 ,并 且 执 行 其 中 
的 代码 ,因此 必须 实现 这 个 方法 。 这 部 分 代码 主要 是 进行 变量 的 初始 化 ,完成 Activity 的 
初始 化 ,其 中 最 主要 的 是 必须 调用 setContentView() 方 法 ,为 Activity 的 用 户 界面 定义 布 
局 ,就 是 初始 化 显示 界面 。 

(2) onPause() : 该 当 用 户 离 开 当 前 的 Activity 时 ,系统 调用 此 方法 。 

在 Android 项 目 中 ,创建 一 个 新 的 类 ,定义 一 个 新 的 Activity, 见 代码 2. 1 。 

代码 2.1 ExampleActivity. java 


import android.app.Activity; 
jimport android.os.Bundle; 


public class ExampleActivity extends Activity { 

@ Override 

Public void onCreate (Bundle savedInstanoeState) { 
Super.anCreate (savedInstanoeState); 
setContentView (R.layout .main); 

} 

@ Override 

Protected void onPause() { 
super.onPause ()7 

} 
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每 个 Android 应 用 程序 都 是 一 个 独立 的 Android 项 目 ,都 有 一 个 AndroidManifest 
.xml 文件 ,这 里 面 是 这 个 项 目 中 所 包含 的 组 件 和 应 用 程序 的 配置 说 明 。 在 创建 项 目的 时 
候 ,Eclipse 集成 开发 工具 会 自动 创建 这 个 文件 。 将 新 定义 的 Activity 的 相关 参数 写 入 
AndroidManifest. xml 文件 的 过 程 , 称 为 Activity 的 声明 。 

Activity 只 有 在 AndroidManifest. xml 中 声明 后 ,才能 够 在 应 用 程序 调用 时 成 功 运 
行 ,系统 才 可 以 访问 到 它们 。 

要 声明 一 个 Activity, 可 以 打开 项 目 根 目 录 下 的 AndroidManifest. xml 文件 ,添加 一 
个 二 activity 之 元 素 作为 二 application 之 元 素 的 子 元 素 , 见 代码 2. 2。 


> 
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代码 2.2 AndroidManifest. xml 


<manifest …> 
<arplication *…> 
< activity android:name= ".ExanpleActivity"/> 


< /application …> 


< hranifest> 
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Android 平台 主要 是 为 移动 终端 开发 的 操作 系统 。 移 动 终端 的 特性 就 是 应 该 能 随时 
在 未 完成 当前 任务 的 时 候 ,切换 到 其 他 任务 中 ,再 次 回来 以 后 还 可 以 继续 完成 刚才 没有 完 
成 的 任务 。 为 什么 设置 Activity 的 生命 周期 呢 ? 

先 看 一 个 典型 的 例子 : 在 编写 短信 时 ,有 一 个 紧急 电话 打 过 来 ,你 必须 要 接 这 个 电 
话 , 如 果 接 完 电话 后 ,你 肯定 希望 继续 编辑 刚才 的 短信 ,以 完成 这 个 任务 。 

为 了 完成 类 似 的 任务 ,Android 系统 需要 同时 执行 多 个 程序 。 但 对 于 移动 终端 这 种 
有 限 资 源 的 平台 来 说 ,同时 执行 多 个 程序 可 以 提高 用 户 友 好 性 ,但 是 也 有 它 的 严重 缺点 。 
每 多 执行 一 个 应 用 程序 ,就 会 多 耗费 一 些 系统 内 存 。 而 手机 里 的 内 存 是 相当 有 限 的 。 当 
同时 执行 的 程序 过 多 ,或 是 关闭 的 程序 没有 正确 释放 掉 内 存 , 执 行 系 统 时 就 会 觉得 越 来 越 
慢 , 甚 至 不 稳定 。 为 了 解决 个 问题 ,Android 引入 了 生命 周期 的 机 制 来 管理 应 用 程序 , 见 
图 2.1。 
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onDestory() 
2.1 Activity 生命 周期 


Android 应 用 程序 的 生命 周期 是 由 系统 框架 进行 管理 ,而 不 是 由 应 用 程序 直接 控制 。 
Android 系统 的 Dalvik 虚拟 机 会 依照 内 存 状况 和 Activity 的 使 用 状态 ,来 自动 管理 内 存 
的 使 用 。 

图 2.1 说 明了 Activity 生命 周期 中 各 个 状态 ,以 及 在 状态 转换 过 程 中 系统 会 调用 的 
方法 。Activity 状态 的 转换 是 由 于 用 户 的 操作 或 其 他 原因 引起 的 。 当 Activity 状态 发 生 
转换 时 ,相关 方法 中 的 代码 就 会 执行 。 例 如 ,在 Activity 创建 启动 时 ,会 依次 调用 其 
onCreate() .onStart() .onResume 方 法 中 的 代码 ; 当 Activity 从 运行 状态 转换 成 暂停 状态 


第 2 章 设计 应 用 界面 \@/ 
时 ,会 调用 其 onPause() 方 法 中 的 代码 。 

Activity 的 生命 周期 中 有 4 种 状态 : 

(1) Active/Running: 在 屏幕 的 前 台 , 叫 做 活动 状态 或 者 运行 状态 (Acetive 或 
Running) 。 

(2) Paused: 如 果 一 个 Activity 失去 焦点 ,但 是 依然 可 见 ( 一 个 新 的 非 全 屏 的 
Activity 或 者 一 个 透明 的 Activity 被 放置 在 栈 顶 ) ,叫做 暂停 状态 (Paused) 。 一 个 暂停 状 
态 的 Activity 依然 保持 活力 (保持 所 有 的 状态 ,成 员 信息 ,和 窗口 管理 器 保持 连接 ), 但 是 
在 系统 内 存 极端 低下 的 时 候 将 被 终止 。 

(3) Stopped: 如 果 一 个 Activity 被 另外 的 Activity 完全 覆盖 ,就 称 为 停止 状态 
(Stopped)。 它 依然 保持 所 有 状态 和 成 员 信息 ,但 是 它 不 再 可 见 , 所 以 它 的 窗口 被 隐藏 , 当 
系统 内 存 需要 被 用 在 其 他 地 方 的 时 候 ,Stopped 的 Activity 将 被 终止 。 

(4) Killed: 如 果 一 个 Activity 是 Paused 或 者 Stopped 状态 ,系统 可 以 将 该 Activity 
从 内 存 中 删除 ,Android 系统 采用 两 种 方式 进行 删除 ,要 么 要 求 该 Activity 结束 ,要 么 直 
接 终 止 它 的 进程 。 当 该 Activity 再 次 显示 给 用 户 时 , 它 必 须 重新 开始 和 重 置 前 面 的 状态 。 

Activity 的 生命 周期 中 有 3 个 关键 的 循环 : 

(1) 整个 的 生命 周期 : 从 onCreate(Bundle) 开 始 到 onDestroy() 结 束 。Activity 在 
onCreate() 设 置 所 有 的 “全 局 ”状态 ,在 onDestory() 释 放 所 有 的 资源 。 例 如 , 某 个 Activity 
有 一 个 在 后 台 运 行 的 线程 ,用 于 从 网 络 下 载 数据 , 则 该 Activity 可 以 在 onCreate() 中 创建 线 
程 ,在 onDestory() 中 停止 线程 。 

(2) 可 见 的 生命 周期 : 从 onStart() 开 始 到 onStop() 结 束 。 在 这 段 时 间 , 可 以 看 到 
Activity 在 屏幕 上 ,尽管 有 可 能 不 在 前 台 , 不 能 和 用 户 交 互 。 在 这 两 个 接口 之 间 , 需 要 保 
持 显示 给 用 户 的 界面 数据 和 资源 等 ,例如 ,可 以 在 onStart 中 注册 一 个 IntentReceiver 来 
监听 数据 变化 导致 界面 的 变动 , 当 不 再 需要 显示 时 候 , 可 以 在 onStop() 中 注销 它 。 
onStart() 和 onStop() 都 可 以 被 多 次 调用 ,因为 Activity 随时 可 以 在 可 见 和 隐藏 之 间 
转换 。 

(3) 前 台 的 生命 周期 : 从 onResume() 开 始 到 onPause() 结 束 。 在 这 段 时 间 里 ,该 
Activity 处 于 所 有 Activity 的 最 前 面 ,与 用 户 进行 交互 。Activity 可 以 经 常 性 地 在 
Resumed 和 Paused 状态 之 间 切 换 , 例 如 , 当 设 备 准 备 休 眼 时 , 当 一 个 Activity 处 理 结果 
被 分 发 时 , 当 一 个 新 的 Intent 被 分 发 时 等 。 所 以 在 这 些 接口 方法 中 的 代码 应 该 属于 非常 
轻 量 级 的 。 

Activity 的 整个 生命 周期 的 状态 转换 和 动作 都 定义 在 Activity 的 接口 方法 中 ,所 有 
方法 都 可 以 被 重 载 , 见 代 码 2. 3。 

代码 2.3 Activity 的 接口 


Public class Activity extends ApplicationContext { 
Protected void onCreate (Bundle icicle); 
protected void cnstart (); 
Protected void onRestart (); 
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代码 2.4 是 一 个 Activity 重 写 各 方法 的 例子 PeriodActivity, 包 括 每 一 个 基本 的 生命 
周期 方法 。 在 Eclipse 中 ,选择 Window 一 showView 一 Other, 打 开 一 个 对 话 框 。 然 后 在 
左 侧 的 列表 框 中 选择 Android 目录 ,选择 其 下 的 LogCat, 就 可 以 打开 日 志 窗 口 ,查看 运行 
中 Activity 生命 周期 中 各 方法 写 和 的 日 志 结果 。 运 行 这 个 例子 程序 ,根据 生命 周期 的 描 
述 改变 其 状态 ,然后 查看 日 志 结 果 。 

代码 2.4 PeriodActivity. java 
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// 未 保存 的 数据 ,停止 动画 或 其 他 可 能 会 消耗 ce 的 事情 。 这 个 方法 执 
// 行 的 任务 应 该 非常 快 ,如 果 这 个 方法 不 尽快 返回 结果 ,下 一 个 
//activity 将 无 法 启动 

) 


@ Overriqe 

protected void onstop() { 
super.onStop(); 
Tog-i (TAG, xx*onStop() is running*"); 
// 这 个 活动 不 再 可 见 ,为 停止 状态 

1 


@ Override 

protected void onDestroy() { 
Super.onDestroy(); 
Locg-i (TAG, xx#*onDestroy() is runningex#"); 
// 这 个 活动 被 销毁 
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一 个 应 用 程序 通常 包含 多 个 Activity。 每 个 Activity 都 可 以 设计 完成 特定 的 用 户 操 
作 , 并 且 能 够 启动 其 他 Activity。 例 如 ,一 个 电子 邮件 的 应 用 程序 可 能 有 一 个 Activity, 用 
于 展现 出 新 的 电子 邮件 列表 , 当 用 户 选 择 了 一 个 电子 邮件 ,就 打开 一 个 新 的 Activity 以 查 
看 该 电子 邮件 的 详细 内 容 。 

一 个 Activity 也 可 以 启动 设备 上 的 另 一 个 应 用 程序 中 的 Activity。 例 如 ,如 果 应 用 
程序 想 要 发 送 一 封 电子 邮件 ,可 以 把 邮件 地 址 和 内 容 等 信息 打包 在 一 个 叫 Intent 的 组 件 
中 ,设置 启动 E-mail 应 用 程序 的 “创建 邮件 ”Activity, 并 获取 Intent 中 传递 的 信息 。 当 邮 
件 被 发 送 后 ,Activity 则 重新 展现 ,而 用 户 的 感觉 是 发 送 邮 件 的 功能 好 像 是 应 用 程序 的 一 
部 分 。 虽然 上 述 完 成 的 动作 是 来 自 不 同 的 应 用 程序 ,但 是 Android 系统 将 这 些 Activity 
放 入 到 相同 的 任务 中 ,这 样 就 维护 了 一 个 完整 的 用 户 体验 。 

所 谓 任务 ,就 是 某 些 参与 用 户 交 互 的 Activity 集合 ,其 目的 是 为 完成 某 项 确定 的 工 
作 。Android 系统 通过 栈 结构 来 管理 任务 中 的 这 些 Activity。Activity 按照 被 打开 的 顺 
序 排列 在 栈 中 。 

设备 的 Home 屏幕 是 大 多 数 任务 的 起 点 。 当 用 户 触摸 应 用 程序 的 图 标 ( 或 者 Home 
屏幕 上 的 快捷 方式 ) 时 ,该 应 用 程序 的 任务 就 会 来 到 前 台 。 如 果 该 应 用 的 任务 不 存在 ( 即 
应 用 在 最 近 时 间 段 内 没有 使 用 过 ) ,那么 一 个 新 的 任务 被 创建 ,应 用 的 主 Activity 会 作为 
栈 中 的 根 Activity 打开 。 

如 果 用 户 从 当前 的 Activity 打开 了 一 个 新 的 Activity, 则 新 的 Activity 被 压 入 到 栈 的 
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顶部 ,并 且 成 为 用 户 的 前 端 界面 。 而 原来 的 Activity 仍然 在 栈 中 ,但 是 已 经 变 成 停止 状 
态 , 此 时 系统 会 保留 其 用 户 界面 的 状态 。 当 用 户 按 下 返回 按钮 时 ,当前 的 Activity 就 会 从 
栈 的 顶部 弹出 ( 即 当 前 的 Activity 就 会 被 销毁 ) ,而 原来 的 Activity 就 会 被 重新 恢复 显示 
(其 界面 的 状态 被 系统 保存 )。 在 栈 中 的 Activity 永远 不 会 被 重 排 ,只 有 压 人 和 弹出 操作 。 
这 种 栈 的 读 写 方式 为 “后 进 先 出 ”, 称 其 为 回 退 栈 。 图 2. 2 展示 了 多 个 Activity 切换 的 
过 程 。 


Start Activity 2 Start Activity 3 Navigate back 


| | | 


. 
Foreground Activity > Activity 3 》 


Back Stack Ei | | FE 到 
destroyed 


图 2.2 管理 Activity 的 栈 结构 


如 果 用 户 不 停 地 按 返 回 键 的 时 候 , 那 么 栈 中 每 个 Activity 都 会 依次 弹出 ,并 显示 之 前 
的 Activity, 直 至 用 户 回 到 Home 屏幕 (或 者 当 任 务 启动 时 的 任何 一 个 Activity)。 当 所 有 
的 Activity 都 从 栈 中 弹出 后 ,这 个 任务 就 不 再 存在 。 

一 个 任务 就 是 一 个 完整 的 单元 , 当 用 户 启动 一 个 新 的 任务 时 或 者 使 用 Home 按钮 回 
到 Home 屏幕 的 时 候 , 这 个 任务 就 会 转变 为 后 台 。 
当 任务 处 于 后 台 时 ,里 面 所 有 的 Activity 都 处 于 停 
止 状 态 ,但 是 这 个 任务 的 回 退 栈 仍然 被 完整 保留 。 
当 其 他 任务 变 成 前 台 时 ,当前 的 任务 就 变 成 后 台 ， 
见 图 2.3。 

任务 可 以 回 到 前 台 , 以 便 用 户 继续 之 前 的 操 图 2.3 任务 回 退 栈 的 变化 
作 。 例 如 ,当前 任务 A 共有 两 个 Activity 在 栈 中 ， 
这 时 用 户 按 下 Home 键 切换 到 主屏 ,然后 启动 一 个 新 的 应 用 程序 。 当 主屏 显示 时 ,任务 
A 进入 后 台 ; 而 当 新 的 应 用 程序 启动 时 ,系统 会 为 它 开启 一 个 新 的 任务 B, 其 拥有 自己 的 
回 退 栈 。 如 果 用 户 使 用 这 个 应 用 后 ,用 户 使 用 Home 键 再 次 切换 到 主屏 幕 ,并 且 选 中 那 
个 启动 任务 A 的 应 用 程序 。 此 时 ,任务 A 进入 前 台 ,而 其 栈 中 的 2 个 Activity 仍然 被 完 
整 保留 ,并 且 位 于 栈 顶 的 Activity 重新 恢复 显示 。 此 时 ,用 户 仍然 可 以 从 主屏 切换 到 启动 
任务 B 的 应 用 程序 。 这 也 是 Android 系统 中 多 任务 的 例子 。 

虽然 Android 系统 可 以 在 后 台 同 时 保留 多 个 任务 ,但 是 假如 用 户 同时 运行 着 多 个 后 
台 任 务 时 ,系统 可 能 会 销毁 后 台 Activity 用 于 释放 内 存 ,这 样 的 情况 就 会 导致 Activity 状 
态 的 丢失 。 
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2.2 理解 布局 


Activity 是 Android 应 用 程序 与 用 户 交 互 的 图 形 界面 ,而 Activity 中 的 具体 图 形 控 
件 由 Android 定义 的 View 类 和 ViewGroup 类 的 子 类 对 象 组 成 , 称 为 View 和 
ViewGroup 对 象 。 这 些 对 象 在 Activity 中 的 排列 结构 , 称 为 用 户 界面 的 布局 。View 对 
象 是 Android 平台 上 用 户 界 面 中 的 基础 单元 ,也 可 称 为 控件 。Android 系统 提供 了 许多 
类 型 的 View 和 ViewGroup ,例如 TextView 和 Button 等 类 ,它们 都 是 View 类 的 子 类 。 

其 中 ViewGroup 对 象 可 以 理解 为 一 种 容器 ,类 似 于 Java 中 的 Panel, 用 于 容纳 其 他 
的 控件 对 象 , 并 使 这 些 控 件 对 象 按 照 特定 的 规则 进行 排列 , 即 按照 某 种 布局 排列 。 
Android 的 布局 Layout 是 ViewGroup 的 子 类 ,能够 提供 各 种 不 同 的 布局 结构 ,如 线性 布 
局 .表格 布局 以 及 相对 布局 等 。 

在 Android 平台 ,一 个 Activity 的 用 户 界面 能 够 使 用 层次 关系 的 View 和 
ViewGroup 对 象 组 合 来 设计 布局 ,如 图 2.4 所 示 。 


C ViewGroup ) View View 


View View View 


图 2.4 Activity 用 户 界面 中 视图 对 象 的 层次 关系 


在 第 1 章 提 到 过 ,Android 系统 实现 Activity 的 用 户 界 面 布局 有 两 种 定义 方式 : 一 种 
是 使 用 XML 文件 定义 布局 ,把 布局 文件 置 于 /res/layout 目录 下 ; 男 一 种 是 在 Java 应 用 
程序 中 通过 编程 的 方法 来 创建 View 和 ViewGroup 对 象 , 在 运行 时 实例 化 布局 元 素 , 或 
改变 其 属性 。 

Android 的 布局 资源 文件 主要 用 于 Activity 用 户 界面 或 其 他 的 用 户 界面 组 件 的 布 
局 。 使 用 XML 布局 文件 ,可 以 将 应 用 程序 的 界面 设计 与 控制 逻辑 分 离开 来 ,这 更 有 利于 
用 户 屏幕 不 确定 的 移动 应 用 。 如 果 需 要 调整 界面 设计 ,只 需要 修改 XML 文件 ,而 无 须 修 
改 源 代码 并 重新 编译 。 例 如 ,对 于 不 同 移动 设备 或 用 户 ,不 同 的 屏幕 方向 ,不 同 的 屏幕 尺 
寸 , 不 同 的 语言 等 ,可 以 设计 不 同 XML 布局 文件 ,但 是 可 能 并 不 需要 修改 任何 应 用 程序 
代码 。 此 外 ,对 于 一 个 初学 者 来 说 ,使 用 XML 布局 更 容易 定义 用 户 界 面 的 结构 ,更 容易 
进行 调试 。 因 此 ,本 章 重点 介绍 如 何 使 用 XML 布局 文件 。 布 局 资源 文件 的 具体 语法 见 
代码 2. 5。 

代码 2.5 布局 资源 文件 的 语法 


< ?anl versior= 叫 .0" encoding= "utf- 8"2> 
<ViewGroup xmlns:android= "http://schemas.android.om/apk/res/android" 
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前 面 , 在 设计 用 户 界面 时 已 经 使 用 了 布局 资源 文件 ,这 里 对 照 布 局 资源 文件 的 语法 ， 
再 用 一 个 简单 的 例子 来 说 明 布局 文件 的 具体 定义 和 使 用 过 程 。 例 如 ,假设 创建 的 一 个 新 
的 布局 文件 res/layout/main_activity. xml, 在 用 户 界面 上 定义 了 两 个 组 件 TextView 文 
本 框 和 Button 按钮 , 见 代码 2. 6。 

代码 2.6 布局 文件 示例 


在 Android 应 用 导入 布局 文件 定义 的 用 户 界面 资源 时 ,需要 在 Activity 的 onCreate() 
方法 中 实现 , 见 代码 2.7。 


第 2 章 设计 应 用 界面 Ne 
> 


代码 2.7 导入 布局 资源 文件 


Public void onCreate (Bundle savedInstanoeState) { 
Super .onCreate (savedInstanoeState); 
setContentView (R.layout .main activity); 

了 


如 果 在 Eclipse 中 安装 了 ADT 插件 ,ADT 提供 编写 XML 布局 文件 可 视 化 化 工具 ， 


可 以 在 设计 界面 布局 的 同时 ,对 设计 的 样式 进行 浏览 ,而 且 可 以 将 各 种 控件 拖 忠 到 布局 
中 ,进行 直观 的 图 形 化 设计 , 见 图 2. 5。 


ding config: Er Large Sereen, Landacape Orientation, AP Level 11 [EC 
更 [Gaare 于 |[weped 同 [owime 网 (TremeJosemed Home 网 


=] 回电 | 回回 回 &amlam 


Ten Large Medium sm | -一 
了 


Button 


ou ua | Google 加 加 | we 


图 2.5 Activity 界面 的 图 形 化 设计 工具 


Android 有 5 种 基本 的 布局 对 象 : 

(1) FrameLayout( 框 架 布 局 ) 。 

(2) LinearLayout( 线 性 布局 ) 。 

(3) AbsoluteLayout( 绝 对 布局 ) 。 

(4) RelativeLayout( 相 对 布局 ) 。 

(5) TableLayout( 表 格 布局 ) 。 

目前 ,在 这 5 种 布局 中 主要 使 用 线性 布局 .相对 布局 和 表格 布局 ,框架 布局 和 绝对 布 

局 已 经 很 少 使 用 。 


221 线性 布局 
线性 布局 (LinearLayout) 是 基础 的 ,使 用 得 比较 多 的 布局 类 型 之 一 。 线 性 布局 的 作 
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用 就 像 其 名 字 一 样 ,根据 设置 的 垂直 或 水 平 的 属性 值 , 将 所 有 的 子 控件 按 垂 直 或 水 平 进行 

组 织 排列 。 当 布局 方向 设置 为 垂直 时 ,布局 里 面 的 所 有 子 控件 被 组 织 在 同一 列 中 ; 当 布 局 

方向 设置 为 水 平时 ,所 有 子 控件 被 组 织 在 一 行 中 ,设置 线性 布局 方向 的 属性 为 android: 

orientation ,其 值 可 以 为 horizontal 或 vertical ,分 别 代 表 水 平 或 垂直 方向 , 见 代 码 2. 8。 
代码 2.8 LinearLayout 语法 格式 


< LinearTayout xmlns:android= "http://schemas.android.ocom/apk/res/android" 
android:orientation= "horizontal" 
ardroid: layout width= "fil1 parent" android:layout height= "wrap omtent"> 


<!-~add children here- -> 
< /LinearLayout> 


在 这 段 代 码 中 ,还 设置 了 android:layout_width 和 android:layout_height 属性 ,分 别 
代表 了 布局 的 宽度 和 高 度 ,这 两 个 属性 的 值 可 以 为 fill_parent, 其 代表 将 视图 扩展 以 填充 
所 在 容器 (也 就 是 父 容器 ) 的 全 部 空间 。 还 可 以 使 用 android: gravity 属性 设置 布局 内 组 
件 的 对 齐 方式 ,其 值 可 以 为 top .buttom \left right ,center_vertical 等 。 

设置 边 距 布局 的 参数 有 layout_marginBottom ,layout_marginLeft layout_marginRight 
和 layout_marginTop, 分别 代表 离 某 元 素 底 边 
缘 、 左 边缘 、 右 边缘 和 顶 边缘 的 距离 。Android 的 


border 


margin 和 padding 跟 HTML 的 是 一 样 的 , 见 content 国 margin 

图 2.6 padding 
通俗 地 理解 ,padding 为 内 边框 ,margin 为 外 

边框 ,代码 2.9 示例 了 如 何 设置 一 个 线性 布局 的 图 2.6 布局 属性 示例 


代码 2.9 设置 线性 布局 边框 


android: layout. marginBottom= "25dip" 
android: layout marginLeft— "10dip" 
android:layout marginTop= "10dip" 
android: layout. marginRight— "]0dip™" 
android:paddingLeft= "dip" 
android:paddingTop= "ldip" 


如 果 左 右上 下 都 是 相同 的 设置 , 则 可 以 按照 如 下 代码 直接 设置 。 
android: layout marginBottoam= "25dip" 


android: layout. margin= "10dip" 
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在 线性 布局 所 定义 的 界面 上 ,所 有 的 子 元 素 都 被 堆放 在 其 他 元 素 之 后 ,因此 一 个 垂直 
列表 的 每 一 行 只 会 有 一 个 元 素 ,而 一 个 水 平 列表 将 会 只 有 一 个 行 高 。 

线性 布局 的 可 选 属性 layout_weight, 能 够 指定 每 个 子 
控件 在 父 级 线性 布局 中 的 相对 重要 程度 。 线 性 布局 还 支持 
为 单独 的 子 元 素 指 定 weight, 这 样 避免 了 在 一 个 大 屏幕 中 ， 
一 串 小 对 象 挤 成 一 堆 的 情况 ,而 是 允许 它们 放大 填充 空白 。 
子 元 素 指定 一 个 weight 值 , 剩 余 的 空间 就 会 按 这 些 子 元 素 
指定 的 weight 比例 分 配给 这 些 子 元 素 。 默 认 的 weight 值 
为 0。 例 如 ,有 三 个 文本 框 ,其 中 两 个 指定 了 weight 值 为 1， 
那么 ,这 两 个 文本 框 将 等 成 比例 地 放大 ,并 填 满 剩余 的 空 
间 ,而 第 三 个 文本 框 不 会 放大 。 图 2.7 是 一 个 简单 的 线性 
布局 例子 。 图 2.7 线性 布局 运行 界面 

要 实现 这 个 界面 ,需要 下 面 几 个 步骤 : 

(1) 在 Android 项 目的 src 目录 下 ,创建 显示 界面 的 LinearLayoutActivity 类 , 见 代 
码 2.10。 

(2) 创建 布局 文件 linear_layout. xml, 存 放 在 /res/layout 目录 下 , 见 代码 2. 11。 

(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 LinearLayoutActivity 的 声明 , 见 
代码 2. 12。 

代码 2.10 LinearLayoutActivity. java 


import n.edu.uibe.mc. .sanple.R; 
import android.app.Activity; 
jimport android.o0s.Bundle; 


Public class LinearLayoutActivity extends Activity { 


@ override 

protected void oncreate (Bundle savedInstanoeState) { 
//mODD Dito- generated method stub 
super.onCreate (savedInstanoeState); 
SetContentView (R.layout.linear layout); 


} 


代码 2. 10 中 的 setContentView(R. layout. linear_layout) 表 示 把 布局 文件 linear_ 
layout. xml 中 定义 的 控件 和 排列 显示 在 LinearLayoutActivity 定义 的 Activity 中 。 
代码 2.11 linear_layout. xml 


< ?al version= "1 .0" encodingr "utf_ 8"2> 
< LinearTayout xmlns:androidF "http://schemas.android.comapk/res/android" 
android:layout width= "fil1 Parent 
android:layout height= "fil] parent™" 
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代码 2. 11 中 定义 了 三 个 线性 布局 。 外 层 的 线性 布局 ,通过 android: orientation 一 
"vertical" 定义 布局 内 的 空间 按 垂直 方向 排列 。 这 个 外 层 布 局 中 有 两 个 控件 ,分 别 是 设置 
成 水 平方 向 和 设置 成 垂直 方向 的 两 个 线性 布局 ,第 一 个 线性 布局 中 是 4 个 设置 成 不 同 颜 
色 的 TextView 控件 , 按 水 平方 向 排列 ;第 二 个 线性 布局 中 是 4 个 设置 成 "row one” 等 不 
同文 本 的 TextView, 按 垂直 方向 排列 。 

完成 布局 文件 的 定义 后 ,就 可 以 在 AndroidManifest. xml 文件 中 添加 显示 这 个 界面 
的 LinearLayoutActivity。 
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代码 2. 12 LinearLayoutActivity 的 声明 


完成 Activity 的 声明 之 后 ,在 应 用 程序 中 就 可 以 运行 定义 好 的 LinearLayoutActivity。 
222 相对 布局 


相对 布局 (RelativeLayout) 人 允许 布局 中 的 控件 根据 其 他 控件 或 布局 本 身 的 相对 位 置 
来 指定 如 何 排列 。 因 此 ,可 以 使 用 以 右 对 齐 , 或 上 下 .或 置 于 屏幕 中 央 等 形式 来 排列 两 个 
元 素 。 布 局 中 的 控件 是 按 顺 序 排 列 的 ,如 果 第 一 个 元 素 在 屏幕 的 中 央 ,那么 相对 于 这 个 元 
素 的 其 他 元 素 将 以 屏幕 中 央 的 相对 位 置 来 排列 。 如 果 使 用 XML 布局 文件 来 定义 这 种 布 
局 ,之 前 被 关联 的 元 素 必 须 定义 。 

相对 布局 的 相关 属性 见 表 2-1。 
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表 2-1 相对 布局 的 相关 属性 

属 性 含 党 
android:layout_above 将 该 控件 的 底部 置 于 给 定 ID 控件 之 上 
android :layout_below 将 该 控件 的 底部 置 于 给 定 ID 控件 之 下 
android :layout_toLeftOf 将 该 控件 的 右边 缘 与 给 定 ID 控件 左边 缘 对 齐 
android:layout_toRightOf 将 该 控件 的 左边 缘 与 给 定 ID 控件 右边 缘 对 齐 
android:layout_alignBaseline 将 该 控件 的 baseline 与 给 定 IDbaseline 对 齐 
android:layout_alignTop 将 该 控件 的 顶部 边缘 与 给 定 ID 顶部 边缘 对 齐 
android:layout_alignBottom 将 该 控件 的 底部 边缘 与 给 定 ID 底部 边缘 对 齐 
android:layout_alignLeft 将 该 控件 的 左边 缘 与 给 定 ID 左边 缘 对 齐 
android:layout_alignRight 将 该 控件 的 右边 缘 与 给 定 ID 右边 缘 对 齐 
android:layout_alignParentTop 如 果 为 true, 将 该 控件 的 顶部 与 其 父 控件 的 顶部 对 齐 
android :layout_alignParentBottom 如 果 为 true, 将 该 控件 的 底部 与 其 父 控件 的 底部 对 齐 
android :layout_alignParentLeft 如 果 为 true, 将 该 控件 的 左 部 与 其 父 控件 的 左 部 对 齐 
android:layout_alignParentRight 如 果 为 true, 将 该 控件 的 右 部 与 其 父 控件 的 右 部 对 齐 
android :layout_centerHorizontal 如 果 为 true, 将 该 控件 的 置 于 水 平 居 中 
android: layout_centerVertical 如 果 为 true, 将 该 控件 的 置 于 垂直 居中 
android:layout_centerInParent 如 果 为 true, 将 该 控件 的 置 于 父 控件 的 中 央 
android:layout_marginTop 上 偏 移 的 值 
android:layout_marginBottom 下 偏 移 的 值 
android:layout_marginLeft 左 偏 移 的 值 
android :layout_marginRight 右 偏 移 的 值 


图 2. 8 是 采用 RelativeLayout 布局 显示 的 效果 。 


2.8 ”RelativeLayout 布局 显示 结果 


要 实现 这 个 界面 ,需要 下 面 几 个 步骤 : 

(1) 创建 显示 界面 的 RelativeLayoutActivity 类 , 见 代 码 2. 13。 

(2) 创建 布局 文件 relative_layout. xml, 存 放 在 /res/layout 目录 下 , 见 代码 2. 14。 
(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 RelativeLayoutActivity 的 声明 。 
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代码 2.13 RelativeLayoutActivity. java 


代码 2.14 relative_layout. xml 


<Button 
android:layout widthr "wrap oontent™" 
android:layout height= "wrap content" 
android:layout alignmop= "@ id/ok" 
android:layout toreftof= "@ id/ok" 
android:text= "Cancel"/> 


< /Relativerayout> 


223 表格 布局 


表格 布局 (TableLayout) 把 用 户 界面 按 表格 形式 划 为 行 和 列 ,然后 把 控件 分 配 到 指定 
的 行 或 列 中 。 一 个 表格 布局 由 许多 的 TableRow 组 成 ,每 个 TableRow 定义 一 行 row。 
表格 布局 容器 不 会 显示 行 、 列 或 单元 格 cell 的 边框 线 。 每 行 可 有 0 个 或 多 个 的 cell; 每 个 
cell 能 容纳 一 个 View 对 象 。 表 格 允 许 cell 为 空 ,但 cell 不 能 跨 列 。 

(1) android: collapseColumns: 以 第 0 行为 序 , 隐藏 指定 的 列 。android: 
collapseColumns 王 0,2 意思 是 把 第 0 和 第 2 列 隐藏 。 

(2) android:shrinkColumns: 以 第 0 行为 序 , 自 动 延伸 指定 的 列 填充 可 用 部 分 ， 当 
LayoutRow 里 面 的 控件 还 没有 布 满 布 局 时 , shrinkColumns 不 起 作用 ,设置 了 
shrinkColumns 二 0,1,2, 布 局 完全 没有 改变 ,因为 LayoutRow 里 面 还 剩 足够 的 空间 。 当 
LayoutRow 布 满 控件 时 ,设置 了 shrinkColumns 王 2, 则 

么 件 自动 向 垂直 方向 填充 空间 。 

(3) android:stretchColumns: 以 第 0 行为 序 , 尽 量 
把 指定 的 列 填充 空白 部 分 :设置 stretchColumns 二 1, 则 
结果 如 图 2.9 所 示 ,第 1 列 被 尽量 向 右 填充 ,第 2 列 被 压 
挤 到 最 后 边 。 

要 实现 图 2.9 这 个 界面 ,需要 下 面 几 个 步 又: 

(1) 创建 显示 界面 的 TableLayoutActivity 类 。 

(2) 创建 布局 文件 table_layout. xml, 存 放 在 /res/layout 目录 下 , 见 代码 2. 15。 

(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 TableLayoutActivity 的 声明 。 

代码 2.15 table_layout. xml 


图 2.9 表格 布局 运行 界面 


< Pal version= "1 .0" enooding= "utf- 8"?> 

< TableLayout >mlns:androidF "http://schemas.android.om/apk/res/android" 
android:layout width= "fFil] parent™" 
android:layout height= "fil1 parent" 
android:stretchColums= "1"> 
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224 使 用 布局 


Android 的 用 户 界面 布局 是 在 XML 文件 中 静态 记载 ,在 Android 的 Java 程序 中 动 
态 加 载 的 。 当 编译 Android 应 用 程序 时 ,每 一 个 XML 布局 文件 被 编译 成 View 视图 资 
源 ,应 用 程序 代码 在 Activity. onCreate() 回调 中 实现 布局 资源 的 加 载 , 通 过 调用 
setContentView() 传 递 给 它 的 形式 引用 到 布局 资源 R. layout. layout_file_name。 

例如 ,如 果 XML 布局 保存 于 main_layout. xml, 实现 Activity 加 载 的 代码 如 代 
码 2. 16 所 示 。 

代码 2.16 Activity 加 载 布局 文件 资源 
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1. 重用 布局 

Android 用 户 界面 的 布局 是 可 以 重用 的 。 重 用 布局 的 功能 非常 强大 ,因为 它 允 许 你 
创建 可 重复 使 用 的 复杂 的 布局 。 在 应 用 程序 中 ,用 户 界面 布局 中 相同 或 类 似 的 任何 元 素 
都 可 以 被 提取 出 来 ,定义 成 一 个 独立 的 布局 文件 ,单独 管理 ,然后 在 需要 的 时 候 骨 入 到 另 
一 个 布局 中 。 例 如 ,一 个 “是 / 否 ” 的 按钮 面板 ,或 自 定义 的 进度 条 说 明文 字 等 ,单独 定义 后 
可 以 嵌入 到 任何 其 他 布局 中 。 因 此 ,程序 员 可 以 根据 需求 灵活 地 设计 自 定 义 的 视图 ,定义 
自己 特殊 的 布局 。 

如 果 要 有 效 地 重复 使 用 完整 的 布局 ,可 以 在 当前 布局 使 用 的 过 include/ 之 和 
所 merge/ 二 的 标签 嵌入 到 另 一 个 布局 。 

下 面 使 用 一 个 例子 来 具体 说 明 如 何 使 用 一 include/ 二 重用 布局 。 

首先 创建 一 个 布局 文件 titlebar. xml, 其 中 定义 了 标题 栏 和 Logo, 将 其 作为 重用 的 布 
局 , 见 代 码 2. 17。 

代码 2.17 titlebar. xml 


< FrameLayout xmlns:android= "http://schemas.android.om/apk/res/android" 


android:layout height= "wrap content" 
android:background= "@ color/titlebar bg"> 


< ImageView android:layout width= "wrap content" 
android: layout. height= "wrap content" 
android:src= "@ drawable/gafricalogo"/> 
< /FrameLayout> 


创建 男 一 个 布局 文件 reuse_titlebar. xml, 使 用 一 include/ 二 的 标签 把 titlebar. xml 定 
义 的 布局 嵌入 到 这 个 布局 中 , 见 代 码 2. 18。 
代码 2.18 reuse_titlebar. xml 


< LinearLayout mlns:androidF "http://schemas.android.coaplVres/android" 
android:orientation= "vertical" 
android:layout width= "match parent" 
android:layout height= "match parent" 
android:background= "@ color/app bg" 
android:gravity= "oanter horizontal"> 


< include laycut= "@ layout/titlebar"/> 
< TextView android:layout width= "match Parent" 
android:layout height= "wrap oontent" 


android:text= "@ string/hello" 
android:padding= "10dp"/> 


< /LinearTayout> 
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去 merge> 标 签 在 优化 UI 结构 时 起 到 很 重要 的 作用 。 目 的 是 通过 删 减 多 余 或 者 额 
外 的 层级 ,从 而 优化 整个 Android 的 布局 结构 。 

去 merge> 的 另外 一 个 用 法 ,就 是 使 用 壹 merge 之 替代 Layout 标签 作为 重用 布局 文 
件 的 根 节点 时 , 当 另 一 个 布局 文件 使 用 Include 或 者 ViewStub 标签 从 外 部 导入 其 XML 
结构 时 ,可 以 很 好 地 将 它 所 包含 的 子 集 融 合 到 父 级 结构 中 ,而 不 会 出 现 宛 余 的 布局 节点 。 

例如 ,如 果 在 代码 2. 17 中 定义 的 是 线性 布局 , 则 布局 的 规则 与 重用 它 的 代码 2. 18 相 
同 ,使 用 Include 嵌入 布局 中 的 组 件 ,与 父 节点 的 其 他 组 件 都 按照 同样 的 排列 规则 显示 。 
但 是 ,从 整个 Android 的 布局 结构 来 看 ,就 多 了 一 个 线性 布局 元 余 节 点 。 在 代码 2. 17 中 
使 用 过 merge 盖 蔡 代 根 节点 ,嵌入 其 他 布局 文件 后 就 可 以 直接 采用 父 节 点 的 布局 ,与 父 节 
点 的 其 他 组 件 在 同一 级 结构 中 。 

代码 2. 19 merge_layout. xml 


< merge xmlns:android= "http://schemas.android.om/apk/res/android" 
android:layout widthr "match parent" 
android:layout height= "wap_ cntent" 
android:backgroundF "@ oolor/titlebar bg"> 


< ImageView android:layout width= "wrap content" 
android:layout. height= "wrap _ content" 
android:sro= "@ drawable/gafricalogo"/> 
< /nerge> 


2. 获取 控件 

在 布局 文件 中 定义 了 界面 的 布局 之 后 ,如 果 要 在 应 用 程序 中 对 控件 进行 操作 , 则 必须 
根据 布局 文件 中 的 定义 获取 控件 对 应 的 对 象 。 例 如 单 击 图 形 界面 的 一 个 按钮 后 ,需要 对 
这 个 按钮 的 事件 进行 处 理 , 执 行 单 击 按钮 后 的 相应 代码 。 但 这 个 代码 写 在 哪里 呢 ? 应 用 
程序 中 没有 这 个 按钮 的 定义 ,也 没有 创建 这 个 按钮 对 象 。 因 此 ,应 用 程序 必须 根据 布局 文 
件 中 定义 的 其 ID 属性 ,从 Android 系统 中 获取 这 个 按钮 对 象 ,编写 其 对 应 的 事件 处 理 代 
码 , 界 面 才能 够 做 出 正确 的 响应 。 

每 个 View 和 ViewGroup 对 象 都 有 很 多 各 自 的 属性 ,有 些 属性 属于 特定 的 View 对 
象 ,有 些 属性 是 所 有 View 对 象 共同 有 的 。 所 有 对 象 共 同 有 的 属性 都 是 从 根 View 类 继承 
来 的 ,ID 属性 也 是 这 样 。 

在 XML 布局 文件 的 树 形 结构 中 , View 对 象 的 ID 属性 是 这 个 控件 的 唯一 标识 。 在 
XML 布局 文件 中 ,这 个 ID 通常 表现 为 一 个 字符 串 , 当 编译 应 用 程序 时 ,这 个 ID 会 被 引 
用 为 一 个 整数 。 这 是 一 个 公共 属性 ,我 们 会 经 常用 它 。 

下 面 是 在 XML 布局 文件 中 ,定义 一 个 控件 ID 属性 的 语法 : 


android:id= "@ + id/y button" 


XML 解析 器 解析 @ 后 面 的 字符 串 ,my_button 就 是 指定 的 ID 字符 串 ,id 是 指 其 在 
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R. java 文件 中 的 分 类 ;十 表示 这 是 一 个 新 的 资源 名 称 , 必 须 建立 并 加 入 到 项 目的 R. java 
交 件 申 。 

获取 控件 包括 两 个 步骤 : 

(1) 在 布局 文件 中 定义 View 或 部 件 ,并 赋予 唯一 的 ID: 


< Button android:id- "@ + id/my button" 
android: layout width= "wrap content™" 
android:layout. height= "wrap content" 
android:text= "@ string/my button text"/> 


(2) 在 Android 应 用 程序 中 ,使 用 findViewById() 引 用 布局 文件 中 的 部 件 , 创 建 一 个 
部 件 对 象 : 


Button myButton= (Button) findViewById(R.id.my button); 


2.3 样式 和 主题 


样式 是 用 于 指定 View 或 Window 的 外 观 和 格式 的 一 系列 属性 的 集合 。 样 式 可 以 指 
定 控件 或 布局 的 高 (height)、 填 补 (padding)、 字 体 颜色 .字体 大 小 .背景 颜色 等 属性 。 
Android 中 的 样式 与 网 页 设计 中 的 层 琶 样式 表 (CSS) 有 着 相似 的 原理 ,就 是 允许 我 们 将 
设计 从 内 容 中 分 离 出 来 。 例如 ,使 用 一 个 样式 ,可 以 将 下 面 这 个 布局 : 


< TextView 
android:layout width= "fil] parent™" 
android:layout height= "wrap _contentn 
android:textColor= "#00FFOO" 
android:typeface= "mconospace" 
android:text= "@ string/hello"/> 


变 成 这 样 : 


<TextView 
style= "@ style/CodeFont" 
android:text= "@ string/hello"/> 


这 样 ,将 所 有 与 样式 相关 的 属性 从 XML 布局 中 移出 , 放 到 一 个 名 为 CodeFont 的 样 
式 定 义 中 ,通过 样式 属性 应 用 。 

主题 是 一 个 应 用 于 整个 Activity 或 应 用 中 ,而 不 是 某 一 个 单独 的 View。 当 一 个 样式 
被 作为 主题 来 应 用 时 , 则 这 个 样式 对 Activity 或 应 用 中 的 每 个 View 都 有 效 。 例 如 ,我们 
能 把 CodeFont 样式 作为 主题 应 用 于 一 个 Activity, 那 么 这 个 Activity 中 所 有 文本 都 将 是 
绿色 等 宽 字体 。 
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231 定义 样式 


如 果 要 创建 一 套 样 式 , 需 要 在 项 目的 res/values/ 目录 下 创建 一 个 XML 文件 ,来 定 
义 样式 。 定 义 样式 的 XML 文件 名 称 由 程序 员 任 意 指 定 , 但 必须 使 用 . xml 作为 后 缀 , 保 
存在 res/values/ 文件 夹 中 ,而 且 文 件 中 的 根 节点 必须 是 二 resources 记 。 

resources 节点 下 由 style 子 元 素 定义 样式 的 具体 配置 ,其 name 属性 是 所 创建 样式 
的 唯一 标识 。style 元 素 下 可 以 有 多 个 一 item 二 子 元 素 , 具 体 来 定义 View 各 属性 的 配 
置 。<<item> 元 素 包含 一 个 name 属性 和 一 个 对 应 值 ,说 明 这 一 项 设 定 哪 个 View 的 属性 
的 样式 。 二 item 二 元 素 本 身 的 值 可 以 是 一 个 关键 字符 串 .十 六 进 制 颜色 ,或 另 一 个 资源 类 
型 的 引用 或 其 他 值 , 它 是 属性 的 样式 值 。 代 码 2. 20 是 CodeFont 的 样式 定义 ,可 以 看 出 
样式 定义 XML 文件 的 结构 和 语法 。 

代码 2.20 style_sample. xml 


< ?ml versior= "] .0" encoding= "utf- 8"2> 
<Iesources> 
< style name= "CodeFent" parent= "@ android:style/TextAppearanoe .Medium> 
< item name= "android: layout width"> fill parent< /item> 
< item name= "android: layout. height"> wrap content< /item> 
< item name= "android:textColor"> #00FFO0< /item> 
< item name= "android:typefacen> monospaoe< /item> 
< /style> 
< /resources> 


每 个 二 resources 记 元 素 的 子 节点 在 编译 时 都 被 转换 为 一 个 应 用 程序 资源 对 象 ,可 通 
过 一 style 盖 元 素 的 name 属性 的 值 来 引用 。 例 如 前 面 代 码 中 样式 ,通过 style 二 "@style/ 
CodeFont" 语 句 来 引用 。 

在 一 style 二 元 素 中 的 parent 属性 是 可 选 的 ,让 我 们 能 够 从 指定 的 style 中 继承 所 有 
属性 。 通 过 这 种 途径 从 一 个 现 有 的 style 中 继承 属性 后 ,可 以 根据 需求 改变 或 添加 的 属 
性 ,从 而 创建 新 的 样式 。 例 如 ,下 面 的 样式 定义 是 从 Android 平台 默认 文本 外 观 样式 继 
承 , 修 改 了 一 下 文本 的 颜色 。 


< style name= "GreenText" parent= "@ android:style/TextAppearanoe"> 
< item name= "android:textColor"> #00FFO0< /item> 
< /style> 


如 果 要 继承 的 是 自 定义 的 样式 ,就 不 必 使 用 parent 属性 ,而 使 用 *. ”把 原 有 的 样式 和 
新 样式 名 连接 起 来 。 例 如 ,下 面 的 代码 创建 了 一 个 新 样式 , 它 继承 前 面 定义 的 CodeFont， 
但 把 颜色 改 为 红色 。 


< style name= "CodeFont .Red"> 
< item name= "android:textColor"> #FF0000< /item> 
< /style> 


Sep/ 基于 hrdroid 平 台 的 移动 互联 网 开发 


这 里 没有 使 用 parent 属性 ,name 属性 以 CodeFont 起 始 , 使 用 ”. ”连接 了 后 面 的 新 样 
式 名 称 。 这 个 新 样式 可 以 通过 @style/CodeFont. Red 来 引用 。 样 式 的 继承 可 以 有 和 多重 。 
例如 下 面 的 代码 ,从 CodeFont 和 CodeFont. Red style 中 同时 继承 ,然后 添加 android: 
textSize 属性 。 


< style name= "CodeFont .Red.Big"> 
< item name= "android:textSize"> 30sp< /item> 
< /style> 


这 种 技巧 仅 适用 于 将 自 定义 的 资源 链接 起 来 ,不 能 用 这 种 方式 继承 Android 内 置 的 
style。 要 引用 一 个 Android 的 内 置 style, 必 须 使 用 parent 属性 。 
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定义 一 个 样式 之 后 ,如 果 对 一 个 View 应 用 了 这 个 样式 ,而 这 个 View 并 不 支持 此 样 
式 中 设 定 的 某 些 属性 ,那么 此 View 将 应 用 那些 它 支持 的 属性 ,并 简单 忽略 那些 不 支 
持 的 。 

在 Activity 或 应 用 程序 中 有 两 种 方式 来 使 用 样式 : 

(1) 对 一 个 独立 的 View, 在 布局 文件 XML 中 将 style 属性 添加 到 的 此 View 元 
素 中 ; 

(2) 对 一 个 Activity 或 应 用 ,在 AndroidManifest. xml 文件 中 将 android:theme 属性 
添加 到 的 二 activity 二 或 二 application 二 元 素 中 。 

如 果 将 一 个 样式 应 用 到 布局 中 一 个 单独 的 View 上 时 ,此 样式 定义 的 属性 会 仅 应 用 
于 那个 View。 如 果 一 个 样式 应 用 到 一 个 ViewGroup 上 ,其 子 View 元 素 并 不 会 继承 应 用 
的 style 属性 ,只 有 直接 设置 其 子 元 素 的 style 属性 , 才 会 起 作用 。 但 是 ,通过 第 二 种 方式 ， 
将 style 属性 作为 theme 来 应 用 的 方式 ,将 会 把 这 个 style 属性 应 用 到 此 Activity 或 
< 一 application 二 的 所 有 View 元 素 上 。 

下 面 是 在 XML 布局 中 为 View 设置 style 属性 的 简单 语法 : 


<TextView 
style= "@ style/CodeFont" 
android:text= "@ string/hello"/> 
如 果 需 要 对 应 用 程序 中 所 有 Activity 设置 一 个 theme, 则 打开 AndroidManifest. xml 
文件 并 编辑 二 application 二 标签 ,使 之 包含 android:theme 属性 和 style 名 称 , 具 体 设置 代 
码 如 下 。 


< application android:theme= "@ style/Custcntrheme"> 


如 果 希 望 theme 仅 应 用 到 应 用 程序 中 的 某 个 Activity 中 ,那么 就 将 android:theme 
属性 添加 到 一 activity 二 标签 里 。 
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2.4 理解 资源 


Android 应 用 程序 不 仅 包 括 逻 辑 代码 还 包括 资源 文件 ,例如 字符 、 图 片 、 布 局 和 语言 
支持 等 。Android 系统 对 于 资源 的 管理 使 用 了 一 种 将 资源 外 部 化 的 模式 。 这 种 方式 ,使 
得 应 用 程序 可 以 在 代码 编译 时 ,只 是 使 用 资源 的 引用 ,在 代码 编译 后 修改 资源 包含 的 内 容 
也 不 会 影响 程序 的 逻辑 。 从 而 保持 程序 逻辑 和 资源 的 各 自 独立 。 对 于 外 部 资源 ,可 以 通 
过 提供 替代 资源 的 方式 ,支持 不 同 的 语言 或 屏幕 大 小 。 随 着 越 来 越 多 不 同 的 配置 的 
Android 设备 的 出 现 ,这 种 模式 ,对 于 Android 程序 运行 于 复杂 多 变 的 环境 尤其 重要 。 

Android 的 资源 以 文件 形式 ,在 项 目的 res/ 目 录 下 进行 统一 管理 。 为 了 提供 具有 不 
同 配置 的 兼容 性 ,必须 在 项 目的 res/ 目 录 中 组 织 资源 ,在 其 不 同 子 目录 中 存放 不 同 的 资源 
类 型 和 配置 。 对 于 任何 类 型 的 资源 ,都 可 以 指定 默认 情况 下 使 用 的 资源 和 多 个 替代 资源 。 

使 用 默认 资源 的 条 件 是 指 可 以 支持 任何 配置 的 Android 设备 或 当前 的 配置 没有 替代 
资源 匹配 。 图 2. 10 中 的 界面 只 设计 了 一 种 布局 ;而 蔡 代 的 资源 是 为 特定 配置 设计 的 。 
图 2. 11 中 的 界面 为 横向 的 屏幕 设置 了 蔡 代 布局 。 通 过 资源 文件 目录 名 ,Android 系统 会 
自动 应 用 相应 的 资源 文件 ,匹配 设备 当前 的 配置 。 


图 2.11 纵向 与 横向 不 同 布局 


对 于 res/ 目 录 下 的 资源 ,应 用 程序 可 以 通过 引用 资源 ID 号 来 调用 。 具 体 的 资源 ID 
号 能 够 从 R. java 中 查 到 。 对 于 每 一 种 资源 类 型 都 有 一 个 R 的 子 类 对 应 着 (例如 ,RR. 
drawable 中 包含 着 所 有 drawable 资源 ) ,并 且 对 每 个 特定 类 型 的 所 有 资源 都 有 一 个 静态 
的 整 型 数值 一 一 对 应 (例如 ,R. drawable. icon)。 这 个 整 型 数值 就 是 这 个 特定 资源 的 ID 


Ne/ 基于 hndroid 平 台 的 移动 互联 网 开发 


号 ,通过 它 能 获取 对 应 的 资源 。 

一 个 资源 的 ID 号 一 般 的 组 成 如 下 。 

(1) 资源 类 型 : 每 种 资源 都 会 被 分 组 到 一 种 特定 的 资源 类 型 ,例如 string、drawable 
和 layout 等 ,还 有 更 多 的 资源 类 型 ,如 raw、color 等 。 

(2) 资源 名 : 同时 也 是 文件 名 ,不 包括 拓展 名 ;或 者 是 XML 中 android:name 属性 的 
值 ,条 件 是 这 个 资源 是 一 个 简单 的 值 (例如 ,一 个 字符 串 )。 
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res/ 的 子 目录 中 包含 了 所 有 资源 ,资源 目录 名 是 很 重要 的 。 表 2-2 列 出 了 资源 目录 


和 具体 资源 类 型 的 对 照 。 
表 2-2 资源 目录 名 
目录 资源 类 型 

animator/ ”| 存放 定义 属性 动画 的 XML 文件 

anim/ 存放 定义 补 建 动画 的 XML 文件 

color/ 存放 定义 颜色 值 的 XML 文件 

vdbley 存放 位 图 文件 (. png、. jpg、. gif、. 9. png) ,或 者 是 被 编译 成 以 下 可 描画 资源 类 型 的 

XML 文 件 


layout/ 存放 定义 用 户 界面 布局 的 XML 文件 

menu/ 存放 定义 应 用 程序 菜单 的 XML 文件 ,如 选项 菜单 上下文 菜单 或 子 菜单 
raw/ 存放 任意 原生 格式 的 文件 

values/ 存放 包含 简单 值 的 XML 文件 ,如 字符 串 ,整数 以 及 颜色 等 


ey 放 在 这 个 目录 下 的 任意 XML 文件 ,都 可 以 在 运行 时 通过 调用 Resources. getXML() 
方法 来 读 取 


保存 在 表 2-2 中 所 定义 子 目录 中 的 资源 是 默认 资源 。 也 就 是 说 ,这 些 资 源 定义 了 
Android 应 用 程序 用 户 界 面 的 默认 设计 和 内 容 。 值 得 注意 的 是 ,不 能 把 资源 文件 直接 保 
存在 res/ 目 录 中 ,这 样 会 导致 编译 错误 。 

但 是 ,对 于 同一 个 应 用 程序 来 说 ,可 以 根据 Android 设备 的 不 同 特性 和 设置 预先 定义 
不 同类 型 的 资源 ,以 方便 应 用 程序 的 用 户 界面 切合 运行 时 的 硬件 设备 。 例 如 ,可 以 针对 坚 
屏 和 横 屏 设 定 不 同 的 布局 资源 文件 ,以 满足 屏幕 切换 的 需要 。 也 可 以 针对 不 同 的 语言 , 提 
供 不 同 的 字符 串 资源 ,使 得 在 用 户 界面 上 显示 与 设备 语言 相 匹配 的 文字 。 要 给 不 同 的 设 
备 配置 提供 这 些 不 同 的 资源 ,除了 默认 的 资源 以 外 ,还 要 提供 可 选 的 蔡 代 资源 。 
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Android 应 用 程序 引用 某 个 资源 时 ,有 如 下 两 种 方法 。 
(1) 在 Java 应 用 程序 代码 中 直接 调用 ,通过 调用 Resources 类 中 的 方法 来 获取 某 一 
特定 的 资源 ,通过 getResources() 方 法 得 到 Resources 类 的 一 个 实例 。 在 应 用 程序 代码 
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中 引用 资源 的 语法 如 下 : 
[< package name> .]R.< resource type> .<resource name> 


其 中 二 package_name 二 指 资源 所 在 的 包 名 ,如 果 资 源 文件 在 项 目 本 身 的 包 内 时 ,该 
字段 不 需要 填写 。 志 resource_type 二 指 R 类 下 对 应 一 种 特定 资源 类 型 的 子 类 ,如 R. 
String。 到 resource_name 盖 可 以 是 不 包含 文件 扩展 名 的 资源 文件 名 或 者 XML 元 素 中 
android:name 属性 的 值 。 

例如 ,Java 应 用 程序 中 的 语句 R. drawable. my_background_image 调用 了 资源 类 型 
为 drawable, 资 源 名 为 my_background_image 的 Android 资源 。 实 际 上 就 是 引用 了 
Android 定义 好 的 图 片 资 源 。 


// 使 用 drawable 类 型 的 图 片 资 源 给 当前 屏幕 加 载 背 景 
getWindow () .setBackgroundDrawableResouroe (R.drawable.my background image); 
/使 用 Iayout 类 型 的 布局 资源 作为 当前 屏幕 的 布局 
setContentView (R.layout .main screen); 


(2) 在 XML 中 调用 ,通过 特殊 的 XML 语法 引用 R. class 文件 中 的 相关 资源 ID。 在 
XML 资源 文件 中 引用 资源 的 语法 如 下 : 


@ [< package name> :]< resouroe type> /< rescurce name> 


语句 中 各 标记 的 含义 同上 。 
例如 ,XML 布局 文件 中 的 语句 @color/opaque_red 和 @string/hello 调用 了 资源 类 
型 分 别 为 Color 和 String ,资源 名 分 别 为 opaque_red 和 hello 的 Android 资源 。 


// 使 用 color 资 源 类 型 的 cpaque red 的 颜色 资源 作为 文本 颜色 
android:textColor= "@ color/cpaque_ red" 

// 使 用 string 资 源 类 型 的 hello 的 字符 串 作 为 文本 显示 的 内 容 
android:text= "@ string/hello"/> 


上 面 的 语句 中 的 资源 定义 都 在 本 项 目 中 ,这 种 情况 不 需要 说 明 包 。 如 果 要 引 月 
Android 系统 定义 的 资源 , 则 需要 包含 包 名 ,例如 : 


< ?am versior= "1 .0" encoding= "utf- 8"2> 
< EditText xmlns:androidF "http://schemas.android.com/apk/res/android" 
android:layout width= "fil1 parent™ 
android:layout height= "fil1 parentn 
android:textColor= "@ androiqd:color/seccndary text dark" 
android:text= "@ string/hello"/> 
程序 员 应 该 在 任何 时 候 都 使 用 字符 串 资源 ,以 便 应 用 程序 能 够 针对 其 他 语言 进行 本 地 化 。 
同时 程序 员 可 以 在 任何 需要 使 用 自己 提供 的 资源 的 地 方 ,通过 这 两 种 语法 来 调用 。 
在 Android 系统 中 ,不 仅仅 资源 本 身 可 以 被 引用 ,在 定义 样式 时 ,也 可 以 引用 样式 属 
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性 。 引 用 样式 属性 的 语法 与 普通 的 资源 格式 几乎 是 等 同 的 ,但 是 使 用 问号 “?” 取 代 符 号 
“@”, 资 源 类 型 部 分 是 可 选 的 ,语法 格式 如 下 。 


?2[< package name> :] [< resouroe type> /]< resouroe name> 


下 面 的 例子 是 引用 Android 设 定 的 一 个 样式 属性 textColorSecondary 来 设置 布局 中 
TextView 的 文本 颜色 ,使 得 其 匹配 系统 主题 的 * 主 "文本 的 颜色 。 这 里 不 需要 说 明 样 式 
属性 的 资源 类 型 。 


< EditText id "text" 
android: layout width= "fil1 parent" 

android: layout. height= "wrap content"™ 
android:textColor= "? android:textColorSeoondary" 
android:text= "@ string/hello world"/> 


Android 中 包含 了 很 多 标准 的 资源 ,例如 样式 .主题 ,布局 等 。 要 调用 这 些 资源 ,需要 
通过 Android 包 名 来 限定 这 些 资源 。 


2.5 多 屏幕 适应 


移动 终端 的 类 型 繁多 ,屏幕 的 尺寸 .长 宽大 小 比例 也 多 种 多 样 。Android 应 用 程序 要 
运行 在 不 确定 的 屏幕 上 ,Android 系统 需要 处 理 适 配 不 同 显示 屏幕 的 工作 。 因 此 Android 
系统 对 不 同 的 屏幕 尺寸 和 密度 提供 API, 应 用 程序 能 够 设计 提供 不 同 的 屏幕 尺寸 和 密度 
的 用 户 界 面 。 应 用 程序 运行 时 ,系统 通过 适当 的 管理 方式 ,针对 当前 的 屏幕 配置 引用 与 对 
应 的 资源 进行 适 配 ,调整 布局 和 位 图 。 

如 果 没 有 替代 的 布局 资源 ,系统 则 采用 屏幕 默认 设计 ,并 根据 屏幕 的 大 小 进行 缩放 和 
调整 。 但 通过 提供 多 种 屏幕 布局 的 方式 ,可 以 最 大 程度 优化 用 户 体验 。 

Android 系统 是 怎样 支持 多 种 屏幕 的 呢 ? 

在 应 用 程序 用 户 界 面 设 计 中 ,可 以 从 以 下 几 个 方面 来 设 定 对 多 种 屏幕 的 支持 。 

(1) 明确 声明 应 用 程序 支持 的 所 有 屏幕 尺寸 : 在 AndroidManifest. xml 文件 中 ,使 用 
二 supports-screens 记 元 素 说 明 应 用 程序 能 够 支持 的 屏幕 尺寸 。 通 过 声明 应 用 程序 支持 
的 屏幕 尺寸 ,可 以 保证 只 有 那些 屏幕 尺寸 被 应 用 程序 支持 的 设备 才 可 以 下 载 该 应 用 程序 。 

(2) 为 不 同 的 屏幕 尺寸 提供 不 同 的 布局 : 默认 情况 下 ,Android 可 以 重新 调整 应 用 程 
序 的 布局 ,以 适应 当前 的 设备 屏幕 。 但 有 时 候 可 能 调整 后 的 屏幕 布局 不 太美 观 ,这 就 需要 
应 用 程序 针对 特殊 的 屏幕 (过 大 ,或 过 小 ) 设 计 不 同 的 布局 。 在 大 多 数 情况 下 ,这 是 可 行 
的 。 使 用 配置 限定 符 能 够 提供 尺寸 相关 的 资源 ,这 些 限定 符 包 括 small normal large 和 
xlarge。 如 果 应 用 程序 运行 在 Android 3. 2(API Level 13) 以 上 , 则 需要 使 用 sw<N 二 dp 
配置 限定 符 定义 布局 资源 所 需 的 最 小 可 用 宽度 。 例 如 600dp 屏幕 以 上 的 布局 ,放置 在 
layout-sw600dp/ 目 录 下 。 下 面 代码 就 是 一 个 设 定 布局 的 简单 例子 。 
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res/layout/my layout.xml //layout for normal screen size ("default") 
res/layout— small/my layout.xml //layout for small screen size 
res/layout— large/my_layout.xml //layout for large screen size 
res/layout— xlarge/my layout.xml //layout for extra large screen size 
res/layout— xlarge— land/my layout .xm 
//layout for extra large in landscape orientation 


(3) 为 不 同 的 屏幕 尺寸 提供 不 同 的 位 图 : 默认 情况 下 ,Android 系统 会 在 应 用 程序 运 
行 时 ,根据 运行 设备 的 屏幕 缩放 位 图 (. png、 jpg 和 . gif 文件 ) 和 Nine-Patch(. 9. png 文 
件 ) ,使 它们 显示 出 合适 的 物理 尺寸 。 但 这 种 缩放 有 时 会 失真 。 最 好 的 方法 是 为 不 同 的 屏 
幕 密度 提供 不 同 分 辨 率 的 位 图 。 

Android 系统 使 用 限定 符 ldpi、mdpi、hdpi 和 xhdpi, 来 提供 与 密度 相关 的 资源 。 如 下 
代码 为 高 密度 屏幕 提供 的 位 图 放 在 drawable-hdpi/ 目 录 下 。 


res/drawable— mdpi/my_ icoon.png //bitmap for medium density 
res/drawable— hdpi/my_ icon.png //bitmap for high density 
ITes/drawable xhdpi/my_ icon.Png //bitmap for extra high density 


当 Android 应 用 程序 运行 时 ,系统 怎样 使 用 适当 的 可 选 资源 呢 ? 系统 会 根据 当前 屏 
幕 的 大 小 和 密度 配置 ,查找 应 用 程序 提供 的 布局 和 密度 相关 资源 ,确定 最 佳 匹配 的 资源 目 
录 下 的 资源 。 例 如 ,应 用 程序 在 一 个 高 密度 的 大 屏幕 上 显示 一 个 drawable 资源 ,系统 会 
寻找 最 接近 此 大 屏幕 的 布局 ,高 密度 drawable 目录 的 资源 来 使 用 。 

如 果 没 有 匹配 的 资源 是 可 用 的 ,系统 将 使 用 默认 的 资源 并 且 对 其 进行 缩放 来 适应 当 
前 的 屏幕 尺寸 和 和 密度。 默认 的 资源 是 那些 没有 配置 限定 符 的 资源 。 


2.6 小 结 


本 章 主要 介绍 了 Activity 的 概念 和 生命 周期 ,以 及 如 何 使 用 Activity 类 创建 用 户 界 
面 。Activity 是 Android 的 四 大 基本 组 件 之 一 ,通过 Activity, 用 户 可 以 与 移动 终端 进行 
交互 。Activity 的 生命 周期 中 有 Active/Running、Paused、Stopped 和 Killed 四 种 状态 。 

本 章 还 着 重 介绍 了 布局 概念 和 分 类 。Activity 中 的 具体 图 形 控件 由 Android 定义 的 
View 类 和 ViewGroup 类 的 子 类 对 象 组 成 ,这 些 对 象 在 Activity 中 的 排列 结构 , 称 为 用 户 
界面 的 布局 。Android 有 5 种 基本 的 布局 对 象 : 框架 布局 (FrameLayout)、 线 性 布局 
(LinearLayout) ,绝对 布局 (AbsoluteLayout)、 相 对 布局 (RelativeLayout) 和 表格 布局 
《TableLayout)。Android 的 用 户 界 面 布局 是 在 XML 文件 中 静态 记载 ,在 Android 的 
Java 程序 中 动态 加 载 的 。 在 这 一 章 中 ,针对 每 一 种 基础 布局 ,使 用 具体 的 代码 实现 说 明 
了 如 何在 用 户 界面 中 使 用 这 些 布局 。 

在 本 章 的 偏 后 部 分 介绍 了 如 何 使 用 Android 项 目 中 的 样式 和 资源 的 概念 。 


事件 监听 器 和 控件 


Android 的 事件 监听 是 整个 消息 传递 的 基础 和 关键 ,涉及 两 类 对 象 : 事件 发 生 者 和 
事件 监听 者 。 事件 发 生 者 是 事件 的 起 源 , 它 可 以 是 一 个 按钮 .编辑 框 等 。 事件 监 听 者 就 是 
事件 的 接收 者 ,如 果 要 想 接收 某 个 事件 , 它 必须 对 该 事件 的 发 生 者 注册 对 应 的 事件 监 
听 器 。 

这 一 章 主 要 介绍 了 Android 系统 的 事件 处 理 机 制 ,包括 Android 系统 提供 哪些 方法 
和 机 制 ,来 响应 用 户 在 Activity 上 对 图 形 组 件 的 动作 ,以 及 如 何 实现 用 户 交互 后 所 进行 的 
处 理 过 程 。 


3.1 事件 处 理 机 制 


由 于 Android 应 用 程序 使 用 Java 语言 编写 ,在 应 用 程序 运行 中 ,用 户 对 移动 终端 键 
盘 . 屏 幕 和 位 置 的 操作 都 转化 成 事件 对 象 ,Android 系统 通过 对 这 些 事件 的 捕获 后 ,执行 
相应 的 处 理 代码 ,实现 与 用 户 的 交互 ,完成 预定 的 功能 。 这 个 过 程 就 是 Android 的 事件 
处 理 。 
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Android 的 事件 处 理 机 制 有 两 种 ,基于 监听 接口 和 基于 回调 机 制 。 这 两 种 机 制 的 原 
理 和 实现 方法 都 有 所 不 同 。 

1. 基于 监听 接口 的 事件 处 理 机 制 

事件 机 制 是 处 理事 件 的 方式 和 方法 。Android 的 基于 监听 接口 的 事件 处 理 机 制 , 完 
全 采用 了 Java 的 事件 处 理 机 制 。 

Java 的 事件 处 理 基于 委托 事件 处 理 模 型 ,把 事件 的 发 生 与 事件 的 处 理 相 分 离 , 巾 监 
听 器 监听 (等 待 ) 事 件 发 生 ,事件 发 生 后 再 由 监听 器 委托 事件 处 理 器 处 理 。Java 采取 了 授 
权 事 件 模型 (Delegation Event Model) ,事件 源 可 以 把 在 其 自身 所 有 可 能 发 生 的 事件 分 别 
授权 给 不 同 的 事件 处 理 者 来 处 理 。 

在 事件 处 理 的 过 程 中 ,主要 涉及 3 个 主要 部 分 : 事件 源 、 事 件 和 事件 处 理 。 

(1) 事件 源 (Event Source) : 是 指 触摸 屏 、 键 盘 或 位 置 传感器 操作 针对 的 控件 或 容 
器 。 事 件 发 生 时 ,也 就 是 出 现 某 个 控件 被 触摸 操作 ,或 移动 终端 位 置 移动 ,这 个 控件 ,也 就 
是 事件 源 类 负责 发 出 事件 发 生 的 通知 ,并 通过 事件 源 查找 自己 的 事件 监听 者 队列 ,并 将 事 
件 信息 通知 队列 中 的 监听 者 来 完成 。 同 时 ,事件 源 还 在 得 到 有 关 监 听 者 信息 时 负责 维护 
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自己 的 监听 者 队列 。 

(2) 事件 (Event) : 是 指 对 组 件 或 容器 的 触摸 屏 、 键 盘 或 位 置 的 一 个 操作 ,用 类 描述 。 
例如 键盘 事件 类 KeyEvent 描述 键盘 事件 的 所 有 信息 : 键 按 下 释放、 双击 组合 键 以 及 键 
码 等 相关 键 的 信息 。 

(3) 事件 处 理 (Event Handler) : Java 的 事件 处 理由 事件 监听 器 类 和 事件 监听 器 接口 
来 实现 。 事 件 发 生 后 ,事件 源 将 相关 的 信息 通知 对 应 的 监听 器 ,事件 源 和 监听 者 之 间 通 过 
监听 者 接口 完成 这 类 的 信息 交换 。 事 件 监 听 者 类 就 是 事件 监听 者 接口 的 具体 实现 , 当 事 
件 发 生 后 ,该 主体 负责 进行 相关 的 事件 处 理 , 同 时 , 它 还 负责 通知 相关 的 事件 源 , 自 己 关注 
它 的 特定 的 事件 ,以 便 事件 源 在 事件 发 生 时 能 够 通知 该 主体 。 

图 3. 1 显示 了 委托 事件 模型 的 原理 。 外 部 的 操作 ,例如 按 下 按键 .触摸 屏幕 单 击 按钮 
或 转动 移动 终端 等 动作 ,会 触发 事件 源 上 的 事件 。 对 于 单 击 按钮 的 操作 来 说 ,事件 源 就 是 
按钮 , 它 会 根据 这 个 操作 生成 一 个 按钮 按 下 的 事件 对 象 ,这 对 于 系统 来 说 ,就 产生 了 一 个 
事件 。 


4. 触 发 事件 监听 器 , 事件 本 身 
作为 参数 传人 到 事件 处 理 器 


事件 监 
事件 改 叶 器 调用 事件 处 理 器 ， 
处 理事 件 


事件 处 理 器 事件 处 理 器 事件 处 理 器 .……… 
图 3.1 Android 事件 监听 处 理 机 制 


事件 的 产生 会 触发 事件 监听 器 ,事件 本 身 作 为 参数 传人 到 事件 处 理 器 中 。 事 件 监 听 
器 是 通过 代码 在 程序 初始 化 时 注册 到 事件 源 的 ,也 就 是 说 ,在 按钮 上 设置 一 个 可 以 监听 按 
钮 操作 的 监听 器 ,并 且 通 过 这 个 监听 器 调用 事件 处 理 器 ,事件 处 理 器 里 针对 这 个 事件 所 编 
写 的 代码 ,例如 弹出 一 条 信息 。 

监听 器 是 系统 提供 的 Java 接口 ,事件 处 理 器 是 监听 器 接口 中 的 需要 覆盖 的 抽象 
方法 。 
当 事 件 发 生 后 ,系统 会 调用 相应 监听 器 中 的 事件 处 理 代 码 。 这 些 代码 具体 的 实现 方 
法 有 以 下 几 种 形式 。 

。 Activity 本 身 作为 事件 监听 器 类 。 

。 内 部 类 形式 。 

。 外 部 类 形式 。 

。 匿名 内 部 类 。 

无 论 是 哪 种 实现 方式 ,基于 监听 器 的 事件 处 理 都 需要 做 如 下 3 个 工作 。 

(1) 定义 监听 器 类 ,覆盖 对 应 的 抽象 方法 ,在 监听 器 中 针对 事件 编写 响应 的 处 理 
代码 。 
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(2) 创建 监听 器 对 象 。 

(3) 注册 监听 器 。 

2. 基于 回调 的 事件 处 理 机 制 

Android 的 另 一 种 事件 处 理 机 制 是 回调 机 制 。 

通常 情况 下 ,程序 员 写 程序 时 ,需要 使 用 系统 工具 类 提供 的 方法 来 完成 某 种 功能 , 例 
如 调用 Math. sqrt() 求 取 平方 根 。 但 是 , 某 种 情况 下 系统 会 反 过 来 调用 一 些 类 的 方法 , 例 
如 对 于 用 作 组 件 或 插件 的 类 则 需要 编写 一 些 供 系 统 调用 的 方法 ,这 些 专 门 用 于 被 系统 调 
用 的 方法 被 称 为 回调 方法 ,也 就 是 回 过 来 系统 调用 的 方法 。 

Android 平 台中 ,每 个 View 都 有 自己 的 处 理事 件 的 回调 方法 ,开发 人 员 可 以 通过 重 
写 View 中 的 这 些 回调 方法 来 实现 需要 的 响应 事件 。 当 某 个 事件 没有 被 任何 一 个 View 
处 理 时 , 便 会 调用 Activity 中 相应 的 回调 方法 。 例 如 ,有 一 个 按钮 按 下 的 事件 发 生 了 ,但 
编码 过 程 中 这 个 按钮 并 没有 对 这 个 事件 做 任何 处 理 , 它 所 在 的 Activity 中 的 任何 组 件 也 并 
没有 对 这 个 事件 做 任何 处 理 ,这 时 系统 会 调用 Activity 相应 的 回调 方法 onKeyDown() 。 

回调 机 制 实质 就 是 将 事件 的 处 理 绑 定 在 组 件 上 ,由 GUI 组 件 自己 处 理事 件 , 回 调 机 
制 需要 自 定义 View 来 实现 , 自 定义 View 重 写 该 View 的 事件 处 理 方法 就 可 以 。 

例如 ,MyButton. java 继承 了 Button 组 件 ,要 实现 对 按键 的 事件 处 理 , 则 重 写 父 类 的 
booleanonKeyDown(intkeyCode，KeyEventevent) 方 法 。 
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Android 系统 为 不 同 的 控件 和 操作 提供 了 相应 的 监听 器 ,下 面 介 绍 几 个 常用 的 监 
听 器 。 


OnClickListener 接口 处 理 的 是 单 击 事件 。 在 触 控 模 式 下 ,是 在 某 个 View 上 按 下 
并 抬 起 的 组 合 动作 ,而 在 键盘 模式 下 ,是 某 个 View 获得 焦点 后 单 击 确定 键 或 者 
按 下 轨迹 球 事件 。 
OnFocusChangeListener 接口 用 来 处 理 控件 焦点 发 生 改 变 的 事件 。 如 果 注 册 了 这 
个 接口 , 当 某 个 控件 失去 焦点 或 者 获得 焦点 时 都 会 触发 此 接口 中 的 回调 方法 。 
OnCreateContextMenuListener 接口 是 用 来 处 理 上 下 文 菜单 显示 事件 的 监听 接 
口 , 是 定义 和 注册 上 下 文 菜 单 的 另 一 种 方式 。 

OnKeyListener 是 对 手机 键盘 进行 监听 的 接口 ,通过 对 某 个 View 注册 该 监听 , 当 
View 获得 焦点 并 有 键盘 事件 时 , 便 会 触发 该 接口 中 的 回调 方法 。 
OnLongClickListener 接口 与 之 前 介绍 的 OnClickListener 接口 原理 基本 相同 ,只 
是 该 接口 为 View 长 按 事件 的 捕捉 接口 , 即 当 长 时 间 按 下 某 个 View 时 触发 的 
事件 。 

OnTouchListener 接口 是 用 来 处 理 手机 屏幕 事件 的 监听 接口 , 当 为 View 的 范围 
内 触摸 按 下 、 抬 起 或 滑动 等 动作 时 都 会 触发 该 事件 。 


313 实现 简单 的 事件 响应 
图 3. 2 是 单 击 事件 处 理 示 例 , 显 示 了 一 个 Android 程序 界面 在 单 击 按钮 之 前 和 之 后 
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的 两 个 画面 。 这 个 界面 只 有 一 个 按钮 和 一 个 文本 显示 框 。 在 这 里 以 Button 为 例 , 使 用 基 
于 监听 接口 的 事件 处 理 机 制 , 定 义 匿名 内 部 类 监听 器 ,实现 简单 的 按钮 单 击 事件 处 理 。 当 
单 击 按钮 时 ,TextView 文字 将 发 生 改 变 , 并 在 屏幕 上 出 现 一 段 时 间 的 Toast 提醒 。 


3.2 单 击 事件 处 理 示例 


这 个 交互 的 过 程 分 以 下 几 个 步骤 来 实现 

(1) 创建 XML 布局 文件 simple_event. xml, 见 代码 3. 1 

(2) 创建 新 类 SimpleEventActivity. java ,编写 Java 程序 , 见 代 码 3.2 

(3) 修改 AndroidManifest. xml 文件 ,在 其 中 添加 SimpleEventActivity 的 声明 ,在 
AVD 上 运行 程序 。 

(4) 在 简单 事件 响应 Android 界面 上 操作 ,观测 事件 处 理 

代码 3.1 simple_event. xml 


< ?anl version= "1.0" encodingr "utf- 8"?> 

< LinearTLayout xmlns:android- "http://schemas.android. oo/apk/res/android" 
android:layout width= "fil] parent" 

android:layout. height= "fil] parent" 

android:orientation= "vertical"> 


< TextView 
android:id= "@ + id/textviewl" 
android: layout width= "fil] parent" 
android: layout. height= "wrap oontent" 
android:text— "@ string/hello"/> 


< Button 
android:id= "@ + id/button01" 
android: layout width= "60dp" 
android:layout height= "wrap content™" 
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代码 3.2 SimpleEventActivity. java 
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Android 还 有 一 种 更 简单 的 绑 定 事件 监听 器 的 方式 ,就 是 直接 在 界面 布局 文件 中 为 
指定 标签 绑 定 事件 处 理 方法 。 对 于 很 多 Android 标签 而 言 ,它们 都 支持 如 onClick、 
onLongClick 等 属性 。 修 改 上 面 的 代码 ,为 Button 定义 单 击 事件 ,而且 实现 相同 的 功能 。 
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(1) 修改 上 面 代码 ,在 布局 文件 中 为 Button 添加 属性 ,修改 后 的 代码 如 下 : 


<Button 
android:id= "@ + id/button0lm 
android: layout width= "60dp" 
android:layout height= "wrap contentn 
android: layout gravity= mrightn 
android:text= "确定 "/> 
android:onclick= "clickHandler"/> 


为 Button 按钮 绑 定 一 个 事件 处 理 方法 为 clickHandler, 这 意味 着 开发 者 需要 在 该 界 
面 布局 对 应 的 Activity 中 定义 一 个 void clickHandler(View source) 方 法 ,该 方法 将 会 负 
责 处 理 该 按钮 上 的 单 击 事件 。 
(2) 在 Activity 中 ,将 * 使 用 匿名 内 部 类 的 方式 定义 和 创建 监听 器 对 象 , 为 Button 添 
加 事件 监听 器 OnClickListener” 这 部 分 代码 移 除 , 然 后 定义 clickHandler 方法 。 代 码 
如 下 : 
Public void clickHandler (View v) { 
//Toast 提示 控件 
Toast .makeText (SimplepventActivity.this, 哦 们 已 经 单 击 了 按钮 !"， 
Toast .IENSIH IONG) .show(); 
// 将 TextvView 的 文字 发 生 改 变 
textviewl.setText ("一 个 按钮 的 单 击 事件 !"); 
» 


这 样 就 实现 了 界面 按钮 对 单 击 事件 的 响应 。 
3.2 常用 视图 控件 


Android 系统 为 用 户 界面 的 设计 提供 了 很 多 图 形 控件 ,在 这 一 节 中 介绍 一 些 常用 基 
本 的 控件 ,及 其 事件 处 理 方法 。 
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Android 提供 的 按钮 控件 有 很 多 种 ,包括 基本 的 Button、 ImageButton、ToggleButton 、 
CheckBox 和 RadioButton 都 是 按钮 的 类 型 。 

Button 类 控件 继承 自 TextView, 因 此 也 具有 TextView 的 宽 和 高 设置 ,文字 显示 等 
一 些 基 本 属性 。Button 类 控件 在 应 用 程序 中 的 定义 ,与 其 他 图 形 控件 一 样 ,一 般 都 在 布 
局 文件 中 进行 定义 .设置 和 布局 设计 。 

Button 类 控件 一 般 会 与 单 击 事件 联系 在 一 起 。 对 于 基本 的 Button, 可 以 采用 两 种 方式 
处 理 单 击 事件 。 一 种 类 似 4. 1. 2 节 中 的 事件 处 理 方式 ,使 用 Button 的 setOnClickListener() 
方法 为 其 注册 OnClickListener, 把 具体 的 处 理 代码 写 在 onClick(View v) 方法 中 。 男 一 
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种 方法 类 似 4.1. 3 节 中 的 事件 处 理 方法 .在 XML 布局 文件 中 ,使 用 Android:OnClick 属 
性 为 Button 指定 单 击 事件 发 生 时 执行 的 方法 。 
例如 在 布局 文件 中 设 定 了 如 下 代码 : 


<Button 
Android:layout height= "wrap content" 
Android: layout width "wrap oontent" 
Android:text= "@ string/self destruct" 
Android:onclick= "onMyDefined"/> 


当 用 户 单 击 了 Button 时 ,Android 系统 调用 Activity 的 onMydefined(View view) 方 
法 。XML 布局 文件 中 ,使 用 Android:OnClick 属性 指定 的 这 个 方法 ,在 Java 应 用 程序 中 
必须 是 public 的 ,而 且 只 有 一 个 View 类 型 的 参数 。 例 如 : 
Public void orMyDefined (View view) { 
[code 
} 


在 Button 类 控件 都 可 以 用 setText() 方 法 设置 控件 所 显示 文本 的 值 ,也 都 可 以 用 
getText() 获 取 控 件 的 文本 值 。 

在 按钮 类 控件 中 ,除了 Button 之 外 ,还 有 ToggleButton、CheckBox 和 RadioButton 
等 控件 ,它们 的 处 理 稍 有 不 同 ,下 面具 体 说 明 按 钮 类 控件 如 何 对 事件 进行 处 理 。 在 具体 调 
试 运行 过 程 中 ,创建 资源 文件 和 Activity 的 具体 步骤 与 3. 1. 3 节 相同 ,请 参考 其 编写 完整 
的 代码 ,运行 查看 效果 。 

1. 按钮 控件 

按钮 (Button) 控 件 可 以 有 文本 或 者 图 标 ,也 可 以 文本 和 图 标 同时 存在 , 当 用 户 触摸 时 
就 会 触发 事件 ,如 图 3. 3 所 示 。 pg 

根据 按钮 控件 的 组 成 方式 ,创建 按钮 控件 有 如 下 3 种 加 区 

图 3.3 按钮 的 不 同类 型 

方式 。 

(1) 如 果 由 文本 组 成 ,使 用 Button 类 创建 。 


<Button 


(2) 如 果 由 图 标 组 成 ,使 用 ImageButton 类 创建 。 


< ImageButton 
android:layout width= "wrap content" 
android:layout. height= "wrap oontent" 
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android:src= "@ drawable/button icon" 
> 


(3) 如 果 文 本 和 图 标 都 有 .使 用 Button 类 的 android:drawableLeft 属性 。 


<Button 


除了 按钮 上 的 文本 和 图 标 ,按钮 的 外 观 (例如 背景 图 片 和 字体 ) 可 能 会 因为 设备 或 者 
Android 版 本 的 不 同 而 有 所 不 同 , 随 着 Android 版 本 的 升级 ,其 界面 的 样式 也 发 生变 化 ， 
而 厂家 也 会 定制 输入 控件 的 默认 样式 。 

如 果 要 控制 控件 使 用 适用 于 整个 应 用 程序 的 样式 。 例 如 ,要 确保 所 有 运行 Android 
4.0 甚至 更 高 版 本 的 设备 在 应 用 程序 使 用 Holo 主题 ,需要 在 manifest 的 元 素 中 声明 
android:theme 一 "@android:style/Theme. Holo" 。 

在 XML 布局 文件 中 ,可 以 使 用 Button 的 一 些 属性 来 定义 按钮 的 外 观 。 定 制 不 同 的 
背景 ,可 以 指定 二 android:background 二 属性 为 绘图 或 颜色 的 资源 ,也 可 以 是 自 定义 的 背 
景 。 其 他 的 属性 ,例如 字体 、 大 小 、 边 框 等 ,可 以 参照 TextView 和 View 的 XML 属性 。 
详细 的 XML 属性 说 明 可 以 从 链接 : http://developer. android. com/reference/android/ 
R. styleable. html 查阅 。 

下 面 是 一 个 简单 的 例子 ,使 用 了 一 种 无 边框 按钮 。 无 边框 按钮 与 基本 按钮 相似 ,但 是 
无 边框 按钮 没有 无 边框 或 背景 ,但 在 不 同 状态 如 单 击 时 ,会 改变 外 观 。 要 创建 一 个 无 边框 
按钮 ,为 按钮 应 用 二 borderlessButtonStyle 二 样式 ,具体 设置 如 代码 3. 3 所 示 。 

代码 3.3 ”按钮 外 观 设置 


<Button 
android:id- "@ + id/button send" 
android:layout width= "wrap _ content" 
android:layout. height— "wrap _content" 
android:text= "@ string/button send" 
android:onClick= "sendMessage" 
style= "?android:attr/borderlessButtonStyle"/> 


2. 单 选 按钮 控件 

单 选 按钮 (RadioButton) 在 Android 开发 中 应 用 的 非常 广泛 。 单 选 按钮 的 外 形 是 单 
个 圆 形 的 单 选 框 ,具有 选择 或 不 选择 两 种 状态 。 在 单 选 按 钮 没有 被 选中 时 ,用 户 能 够 按 下 
或 单 击 来 选中 它 。 与 复 选 框 不 同 的 是 ,用 户 一 旦 选中 就 不 能 够 取消 选中 。 

一 般 来 说 ,实现 单 选 按钮 需要 由 单 选 按钮 和 单 选 组 合 框 (RadioGroup) 配 合 使 用 。 单 
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选 组 合 框 是 可 以 容纳 多 个 单 选 按钮 的 容器 。 在 没有 单 选 组 合 框 的 情况 下 , 单 选 按 钮 可 以 
全 部 都 选中 ; 当 多 个 单 选 按钮 被 单 选 组 合 框 包 含 的 情况 下 ,只 可 以 选择 其 中 一 个 单 选 
按钮 。 

单 选 按钮 的 事件 处 理 , 可 以 使 用 setOnCheckedChangeListener() 方 法 注册 单 选 按 钮 
的 监听 器 ,也 可 以 采用 在 XML 布局 文件 中 指定 处 理 方法 的 方式 。 

下 面 这 个 例子 在 XML 布局 文件 中 定义 了 一 个 具有 4 个 单 选 按钮 的 单 选 组 合 框 ,一 
个 文本 显示 框 控 件 和 一 个 按钮 控件 , 见 代码 3.4。 当 一 个 单 选 按钮 被 选中 时 ,在 文本 显示 
框 控件 中 显示 选择 项 的 文本 ,如 果 单 击 按钮 ,将 清除 选中 的 项 目 。 

代码 3.4 radiobutton_layout. xml 
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在 这 个 例子 中 没有 指定 事件 处 理 的 方法 ,因此 ,在 Java 应 用 程序 中 ,采用 控件 相对 应 
的 两 个 事件 监听 器 RadioGroup. OnCheckedChangeListener 和 View. OnClickListener 来 
处 理 对 单 选 组 合 框 和 单 选 按钮 的 事件 ,具体 的 事件 处 理 代码 写 在 onCheckedChanged() 和 
onClick() 接 口 方法 中 ,分 别 实现 根据 选项 更 新 文本 显示 框 的 显示 和 清除 单 选 按钮 选中 的 
功能 , 见 代码 3. 5。 
代码 3.5 RadioGroupActivity. java 


jimport an.edu.uibe.mc.sanple.R; 


public class FadioGroupPctivity extends Activity implements 
RadioGroup.OnCheckedChangeLi stener, View.OnClickListener { 
setContentView (R.layout.radicbutton layout); 
mRadioGroup= (RadioGroup) findViewById(R.id.menn); 
mRadioGroup. setonCheckedChangeLi stener (this); 
Button clearButton= (Button) findViewById(R.id.clear); 
clearButton.setOonClickListener (this); 
Public void onCheckedChanged (RadicGroup group, int checkedId) { 
String selection= get'String (R.string.radio group selection); 
String none~ getstring (R.string.radio group none); 
mChoioe. setText (selection 
+ (checkedTd==View.ND ID ? none: checkedId)); 


完成 应 用 程序 编码 后 ,同样 不 要 忘记 要 到 AndroidManifest. xml 中 注册 才能 运行 。 
从 上 面 的 例子 可 以 看 出 ,Android 控件 的 事件 处 理 方法 与 一 般 的 Java 图 形 界面 处 理 
类 似 , 只 是 控件 和 监听 器 有 所 不 同 ,所 采用 的 事件 处 理 机 制 和 原理 以 及 实现 步骤 都 基本 
相同 。 
3. 复 选 框 
复 选 框 (CheckBox) 具 备 选 中 和 未 选中 两 种 状态 。 复 选 框 的 外 形 是 矩形 框 ,可 以 通过 
击 选中 或 取消 选中 。 在 进行 事件 处 理 时 ,应 用 程序 可 以 根据 是 否 被 选中 来 进行 相应 的 
操作 ,并 且 对 复 选 框 加 载 事 件 监听 器 ,来 对 控件 状态 的 改变 做 出 响应 。 
下 面 这 个 例子 ,通过 XML 布局 文件 在 用 户 界面 使 用 复 选 框 控件 来 创建 一 个 复 选 框 ， 


长 
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实现 当 复 选 框 被 单 击 时 ,弹出 一 个 文本 消息 显示 复 选 框 的 当前 状态 。 

(1) 创建 XML 布局 文件 checkbox_layout. xml, 定 义 一 个 复 选 框 控件 ,并 在 其 中 使 用 
android:onClick 属性 指定 事件 处 理 的 方法 名 为 onCheckBoxClicked, 见 代码 3. 6。 

代码 3.6 checkbox_layout. xml 


(2) 创建 新 类 CheckBoxActivity ,实现 XML 文件 中 指定 的 , 单 击 复 选 框 控件 后 的 事 
件 处 理 方法 onCheckBoxClicked(View v) , 见 代码 3.7。 
代码 3.7 CheckBoxActivity. java 
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Toast .makeText (CheckBoxRctivity.this，" 选 中 履 
Toast.IENGTH SHORT) -show()7 
j] else { 
Toast -maksText (CheckBoxRctivity-this，" 没 选 路 
Toast.IENGTH SHORT) .show(); 


} 


完成 应 用 程序 编码 后 ,不 要 忘记 需要 到 AndroidManifest. xml 中 注册 才能 运行 。 

从 上 面 的 例子 可 以 看 出 ,事件 处 理 方法 可 以 采用 与 按钮 相同 的 模式 ,只 是 在 处 理 过 程 
中 ,可 以 针对 复 选 框 不 同 的 状态 进行 不 同 编码 ,实现 不 同 的 功能 。 

4. 开关 按钮 

如 果 设 置 选项 只 有 两 种 状态 ,可 以 使 用 开关 按钮 (ToggleButton) ,如 图 3. 4(a) 所 示 。 
Android 4.0(API 级 别 14) 提 供 了 另 一 种 的 开关 按钮 (Switch) ,这 个 按钮 提供 一 个 滑动 控 
件 , 可 以 通过 添加 Switch 对 象 来 实现 ,如 图 3.4(b) 所 示 。 


Off | on 
(a) (b) 
图 3.4 ToggleButton 和 Switch 对 象 示例 


ToggleButton 和 Switch 控件 都 是 CompoundButton 组 合 按钮 的 子 类 ,并 且 有 着 相同 
的 功能 ,所 以 可 以 用 同样 的 方法 来 实现 它们 功能 。 当 用 户 选择 ToggleButton 和 Switch 
时 ,对 象 就 会 接收 到 相应 的 单 击 事件 。 要 定义 这 个 单 击 事件 的 响应 操作 ,添加 android: 
onClick 属性 到 XML 布局 文件 的 开关 按钮 控件 中 。 例 如 ,代码 3. 8 定义 了 一 个 
ToggleButton 开关 按钮 并 且 设置 了 android:onClick 事件 单 击 响应 属性 。 

代码 3.8 在 布局 文件 中 定义 ToggleButton 


< ToggleButton 
android:id "@ + id/togglebutton" 
android: layout width "wrap_oontent" 
android:layout height= wrap content" 
android:textOn= "Vibrate on" 
androidl:textOFE- "Vibrate off™ 
android:onClick= "onToggleClicked"/> 


在 这 个 布局 对 应 的 Activity 里 ,在 android:onClick 指定 的 onToggleClicked() 方 法 
中 ,定义 事件 处 理 代码 ,如 代码 3.9 所 示 。 
代码 3.9 ”onToggleClicked 事件 处 理 
//Is the toggle on? 
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boolean cn= ((ToggleButton) view) .isChecked () > 


if (on) { 

//Enable vibrate 
Pelse 

//Disable vibrate 
} 


与 其 他 图 形 控 件 一 样 , 除 了 在 布局 文件 中 定义 之 外 ,也 可 以 通过 代码 的 方式 ,为 控件 
注册 一 个 事件 监听 器 。 代 码 3. 10 中 说 明了 为 ToggleButton 注册 监听 器 的 具体 实现 代 
码 : 首先 创建 一 个 CompoundButton. OnCheckedChangeListener 对 象 ,覆盖 OnChecked- 
ChangeListener 接 口 的 抽象 方法 onCheckedChanged() ,在 其 中 具体 实现 单 击 ToggleButton 
对 象 后 的 事件 处 理 ,然后 通过 调用 此 ToggleButton 对 象 的 setOnCheckedChangeListener() 
方法 ,将 监听 器 绑 定 到 按钮 上 。 有 具体 实现 如 代码 3. 10 所 示 。 

代码 3.10 为 ToggleButton 注册 事件 监听 器 


TogglsButton toggle= (ToggleButton) findViewById(R.id.togglebutton); 
toggle.setoCheded hangeListener (new CapouncPuttcn.OnchedkecthanoFIistener( { 
piblic void ochecedhanged CarpouandButtcn huttorView, boolean ischecked) { 
if (ischecked) { 
//The toggle is enabled 
} else { 
//The toggle is disabled 
} 


Ds; 


完整 的 应 用 程序 可 以 参考 CheckBox 和 RadioButton 来 编写 。 完 成 应 用 程序 编码 
后 ,同样 不 要 忘记 要 到 AndroidManifest. xml 中 注册 才能 运行 。 
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Toast 通知 是 在 窗口 表面 弹出 的 一 个 简短 的 小 消息 ,只 填充 消息 所 需要 的 空间 ,并 
且 用 户 当前 的 Activity 依然 保持 可 见 性 和 交互 性 。 这 种 通知 可 以 自动 地 淡 入 淡出 , 且 
不 接收 用 户 的 交互 事件 。 例 如 ,如 果 用 户 正 在 编写 一 封 
邮件 的 时 候 ,需要 接 通 一 个 电话 ,这 时 界面 会 弹出 一 个 
Toast 提示 ,邮件 保存 为 草稿 ,如 图 3. 5 所 示 。 

Toast 是 一 个 在 屏幕 上 显示 片刻 的 提示 消息 ,但 是 
Toast 不 能 获得 焦点 ,不 能 与 用 户 进行 交互 。 可 以 自 定义 
包括 图 像 的 Toast 布局 文件 。Toast 通知 能 够 被 Activity 
或 Service 创建 并 显示 。 如 果 创 建 了 一 个 源 自 Service 的 图 3.5 Toast 显示 示例 
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Toast 通知 , 它 会 显示 在 当前 的 Activity 最 上 层 。 如 果 用 户 需 要 对 通知 做 出 响应 ,可 以 考 
虑 使 用 Android 的 另 一 种 视图 对 象 状 态 栏 通知 (Status Bar Notification) ,这 会 在 后 面 的 
章节 介绍 。 

如 果 要 使 用 Toast, 可 以 直接 用 Toast 类 的 方法 Toast. makeText() 方 法 实例 化 一 个 
Toast 对 象 。 这 个 方法 有 3 个 参数 ,分 别 为 Context、 要 显示 的 文本 消息 和 Toast 通知 持 
续 显 示 的 时 间 。Toast. makeText() 方 法 会 返回 一 个 按 参 数 设置 且 被 初始 化 的 Toast 对 
象 ,Toast 对 象 的 内 容 用 show() 方 法 显示 。 代 码 3. 11 示例 了 在 Activity 的 onCreate() 方 
法 中 如 何 创 建 和 显示 Toast 信息 ,在 其 他 视图 中 实现 的 代码 类 似 。 

代码 3.11 显示 Toast 通知 


Context context= getApplicationContext ()7 
CharSequence text= "Hello toast!"; 
int duration= Toast.IENGTH SHORT; 


Toast toast= Toast .makeText (context, text, duration); 
toast.show() 7 


代码 3. 11 中 最 后 两 行 代码 也 可 以 用 链 式 组 合 方法 写 , 且 避免 创建 Toast 对 象 ,代码 
如 下 : 


Toast .makeText (oontext, text, duration) .show(); 


标准 的 Toast 通知 水 平 居中 显示 在 屏幕 底部 附近 。 如 果 要 把 Toast 通知 放 到 不 同 的 
位 置 显示 ,可 以 使 用 布局 文件 来 设置 Toast 对 象 的 具体 布局 ,然后 在 Activity 加 载 布局 文 
件 后 ,通过 ID 获取 Toast 对 象 ,使 用 show() 方 法 显示 其 文本 消息 。 

下 面 使 用 一 个 简单 的 例子 ,来 说 明 如 何 定义 和 使 用 Toast 自 定义 的 布局 文件 。 要 创 
建 一 个 自 定义 的 布局 文件 ,可 以 在 XML 布局 文件 或 程序 代码 中 定义 一 个 View 布局 , 然 
后 把 View 对 象 传递 给 setView() 方 法 。 代 码 3. 12 中 layout. custom_toast. xml 布局 文 
件 是 专门 为 Toast 对 象 的 布局 所 作 的 定义 ,其 中 第 二 行 代码 android:id 二 "@ 十 id/toast_ 
layout_root" 定 义 了 这 个 Toast 布局 的 id。 这 个 是 一 个 包含 一 个 图 形 和 一 个 文本 框 的 布 
局 ,其 背景 、 对 齐 方式 和 文本 颜色 也 进行 了 设置 。 

代码 3. 12 Toast 自 定义 布局 


< LinearTayout xmlns:android= "http://schemas.android.cm/apk/res/android" 
android:ig= "@ + id/toast. layout root" 
android:orientation= "horizontal" 
android:layout width= "fil1 Parentn 
androiq:layout height= "fil1 parent" 
android:padding= "8dp" 
android:background- 嗜 DAAA" 
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androiq:layout height— "wrap oontent™" 
androiq:layout marginRight— "Sdp” 
Pe 
< TextView android:id= "@ + id/text" 
android: layout widthr "wrap content" 
android:layout height— "wap ontent" 
android:textColor= 啡 FFF" 
> 
</LinearLaycut> 
Toast 的 布局 文件 创建 完成 后 ,需要 把 这 个 布局 应 用 到 用 户 界面 的 Toast 对 象 。 在 
应 用 程序 Activity 的 onCreate() 中 ,首先 导入 Activity 的 布局 资源 文件 ,然后 需要 使 用 
LayoutInflater 的 对 象 ,通过 其 inflate() 方 法 ,利用 布局 文件 名 和 布局 的 id 来 获取 布局 文 
件 中 定义 的 布局 ,下 一 步 使 用 Toast 对 象 的 setView() 方 法 使 用 这 个 布局 , 见 代 码 3. 13 。 
代码 3.13 使 用 自 定义 Toast 布局 


Layout Inflater inflater= getLayout Inflater (); 
View layout= inflater.inflate (R.layout.custom toast, 
(ViewGroup) findViewById(R.id.toast layout root)); 


TextView text= (TextView) layout.findViewById(R.id.text); 
text .setText ("This is a custam toast"); 


Toast toast= new Toast (getApplicationContext ()); 
toast.. setGravity (Gravity.CENTER VERTICAL, 0, 0); 
toast.setDuration (Toast.IENGTH IONG); 
toast..setView (layout); 

toast.show()7 


除非 使 用 setView() 方 法 设置 自 定 义 布局 ,否则 不 要 使 用 公共 的 Toast 类 构造 器 。 
如 果 不 使 用 自 定义 的 布局 ,必须 使 用 makeText (Context，int，int) 方 法 来 创建 Toast 
对 象 。 

代码 3. 13 中 的 setGravity(int，int，int) 方 法 ,可 以 重新 设置 Toast 对 象 的 显示 位 
置 。 这 个 方法 有 3 个 参数 ,分 别 为 Gravity 常量 、X 轴 偏 移 量 、Y 轴 偏 移 量 。 
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Android 用 于 文本 显示 和 编辑 控件 主要 包括 TextView 和 EditText 两 种 。 实 际 上 ， 
Android 的 很 多 控件 都 继承 自 TextView 类 ,包括 Button CheckTextView、EditText 等 ， 
但 用 于 文本 显示 时 ,常用 的 还 是 TextView 和 EditText。 因 此 这 里 主要 介绍 这 两 个 控件 
如 何 定义 和 使 用 。 

1. 文本 显示 框 

文本 显示 框 (TextView) 是 Android 中 常用 的 组 件 之 一 ,用 于 显示 文字 ,类 似 Java 图 
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形 界面 里 的 标签 。 文 本 显示 框 中 提供 了 大 量 的 属性 用 于 设置 文本 显示 框 的 字体 大 小 、 字 
体 颜 色 .字体 样式 等 。 由 于 很 多 控件 都 是 文本 显示 框 的 子 类 ,它们 也 继承 文本 显示 框 的 属 
性 ,这 给 应 用 程序 的 界面 提供 了 多 种 显示 组 合 和 样式 。 

文本 显示 框 的 属性 可 以 直接 在 XML 布局 文件 中 设置 ,也 可 以 在 Java 应 用 程序 中 设 
置 和 修改 。 

例如 ,如 图 3.6 所 示 的 用 户 界面 的 布局 文件 textview_layout. xml 中 定义 了 一 个 文本 
显示 框 , 可 以 仿照 前 面 例子 设置 文本 显示 框 属性 ,并 在 原来 的 基础 上 ,增加 几 个 属性 设置 ; 
android:textColor 二 "#ff0000" 设 置 字体 为 红色 ,android: textSize 二 "24sp" 设 置 字体 为 
24sp，android:textStyle 王 "bold" 设 置 字体 加 粗 。 


3.6 TextView 对 象 的 属性 设置 
如 果 要 在 Java 代码 中 对 文本 显示 框 控件 属性 进行 修改 ,在 其 布局 文件 中 必须 要 给 这 


个 TextView 的 ID 属性 赋值 。 文 本 显示 框 的 ID 属性 是 这 个 文本 显示 框 部 件 的 唯一 标 
识 , 用 于 Java 程序 对 其 进行 引用 。 设 定 文本 显示 框 的 ID 属性 的 具体 语法 如 下 : 


android:id= "@ + id/textview name" 


假设 在 textview_layout. xml 文件 中 设 定 为 android:id 二"@ 十 id/textvw", 没 有 增 
加 属性 的 设置 ,在 Java 应 用 程序 TextViewActivity 中 ,可 以 通过 findViewById() 获 取 文 
本 显示 框 控 件 ,然后 通过 对 象 修改 其 属性 ,也 可 以 达到 同样 的 效果 , 见 代码 3. 14。 

代码 3.14 TextViewActivity. java 


jimport on.edu.uibe.mc.sanple.R; 
import android.app.Activity; 
jimport android.graphics.* } 
import android.os.Bundle; 
jnmport android.util .TypedValue; 
import android.widget.TextView; 


public class TextViewActivity extends Activity { 
@ Override 
public void onCreate (Bndle savedInstanoeState) { 
super.onCreate (savedInstanoeState) ; 
setContentView (R.layout..textview layout); 


// 获 取 布 局 中 定义 的 Textview 组 件 


TextView textView= (TextView) findViewById (R.id.textvw); 
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// 字 体 设置 成 红色 

textView.setTextColor (Color.RED); 

// 设 置 成 24sp 

textView.setTextSize (TypedValue.OMPTEX UNTT SP, 24f); 

// 加 粗 

textView.setTypeface (Typeface.defaultFramstyle (Typeface.BOLD)); 


} 


通过 上 面 的 尝试 ,说 明 通过 Java 代码 程序 和 XML 布局 文件 都 可 以 实现 文本 显示 框 
属性 的 设置 。 不 过 在 Android 应 用 系统 开发 过 程 中 ,还 是 推荐 使 用 XML 进行 布局 和 界 
面 外 观 的 设计 ,使 用 Java 程序 代码 实现 程序 逻辑 。 

2. 文本 编辑 框 

Android 的 文本 编辑 框 (EditText) 是 用 户 和 Android 应 用 进行 数据 交互 的 窗口 ,可 
以 接收 用 户 的 文本 数据 输入 ,并 将 其 传送 到 应 用 程序 中 。 文 本 编辑 框 是 文本 显示 框 的 子 
类 ,所 以 文本 编辑 框 继承 了 文本 显示 框 的 所 有 方法 和 所 有 属性 。 

文本 编辑 框 类 似 于 Java 图 形 界面 的 文本 编辑 框 ,但 与 后 者 相 比 ,增加 从 文本 显示 框 
继承 的 属性 之 后 ,设置 文本 编辑 框 的 显示 和 输入 时 ,就 可 以 根据 不 同 的 需求 设计 出 更 加 有 
个 性 和 特点 的 交互 界面 。 例 如 ,可 以 通过 文本 编辑 框 的 属性 设置 文本 编辑 框 的 最 大 长 度 ， 
空白 提示 文字 等 ,或 者 限制 输入 的 字符 类 型 只 能 为 电话 号 码 。 表 3-1 中 列 出 了 文本 编辑 
框 常 用 的 一 些 属 性 和 说 明 ,这 些 属性 也 同样 适用 于 文本 显示 框 。 

表 3-1 文本 编辑 框 的 属性 


属 性 说 有明 
android :editable 是 否 可 编辑 
android: gravity 设置 控件 显示 的 位 置 :默认 top 
android:height 设置 高 度 
android:hint 设置 EditText 为 空 时 ,文本 提示 信息 内 容 
android:imeOptions 设置 附加 功能 ,设置 右 下 角 IME 动作 与 编辑 框 相关 的 动作 
android:inputType 设置 文本 的 类 型 ,用 于 帮助 输入 法 显示 合适 的 键盘 类 型 
android:lines 设置 EditText 显示 的 行 数 
android:maxLength 设置 最 大 长 度 
a i 设置 文本 的 最 大 显示 行 数 ， 与 width 或 者 layout_width 结合 使 用 ,超出 
部 分 自动 换行 ,超出 行 数 将 不 显示 
android:numeric 设置 为 数字 输入 方式 
android:password 以 小 点 “. ”显示 文本 
android: phoneNumber 设置 为 电话 号 码 的 输入 方式 
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续 表 
属 性 说 上 明 
android :scrollHorizontally 设置 文本 超出 TextView 的 宽度 时 ,是 否 出 现 横 拉 条 
android :textColor 设置 文本 颜色 
android:textColorHighlight | 设置 被 选中 后 的 文本 颜色 ,默认 为 蓝 色 
android:textColorHint 设置 提示 文本 颜色 ,默认 为 灰色 
android:textSize 设置 文字 大 小 ,推荐 度量 单位 <sp” 


android :textStyle 


设置 字形 (bold ,italic .bolditalic) 其 一 


android:typeface 


设置 文本 字体 (normal sans .serif .monospace) 其 一 


android: width 


设置 宽度 


布局 设计 时 ,可 以 根据 需要 ,在 XML 文件 使 用 上 面 某 些 文本 编辑 框 的 属性 ,来 进行 
特殊 的 设置 。 例 如 ,要求 文本 编辑 框 中 输入 特定 个 数 的 字符 ,比如 身份 证 号 .手机 号 码 等 ， 
可 以 使 用 android:maxLength 王 "18" 设 定 。 下 面 给 出 一 个 例子 ,说 明了 如 何 使 用 文本 编 
辑 框 的 常用 属性 , 见 代码 3. 15 。 

代码 3.15 edittext_layout. xml 


< ?ml version= "1.0" enooding= "utf- 8"?> 

< LinearLayout xmlns:android= "http://schemas.android.oam/apk/res/android" 
android:layout width= "fil] parent" 
android: layout height= "fill parent" 
android:orientation= "vertical"> 


<EditText 


android:id= "@ + id/edit textl" 
android:layout width= "fill Parent" 
android: layout. height= "wrap_ oontent" 
android:hint= "请 输入 用 户 名 …" 
android:maxIength= "40"/> 


<EditText 


android:id= "@ + id/edit text2" 
android: layout width= "fill parent" 
android: layout. height= "wrap oontent" 
android:hint= "请 输入 用 户 和 名 …" 
android:maxTength= "40" 
android:textColorHint= 嗜 238745"/> 


< EditText 


android:id= "@ + id/edit text3" 
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android:layout width= "Fill parent" 
android:layout height= "wrap content" 
android:hint= "请 输入 密码 …" 
android:inputTyper "textPassword"/> 


< EditText 
android:id= "@ + id/edit text4" 
android:layout width= "fill parent" 
android:layout height= "wrap content" 
android:hint= "请 输入 电话 号 码 …" 
android:inputType= "phone"/> 


< EditText 
android:id= "@ + id/edit. text5" 
android:layout widthr "fill parent" 
android: layout. height= wrap content" 
android:hint= "请 输入 数字 …" 
android:inputTyper "nunberSigned"/> 


< EditText 
android:id= "@ + id/edit text6" 
android:layout widthr "fill parent" 
anciroid:layout height= "wrap_content" 
android:hint= "请 输入 日 期 …" 
android:inputType= "date"/> 


< /LinearIayout> 


编写 Java 程序 代码 ,引用 edittext_layout. xml 定 
义 的 布局 ,运行 应 用 就 会 看 到 如 图 3.7 所 示 的 效果 。 

在 应 用 程序 给 出 的 界面 上 操作 ,可 以 体验 文本 编辑 
框 不 同属 性 设置 对 输入 的 影响 ,了 解 如 何 使 用 这 些 属性 
来 满足 应 用 程序 界面 输入 的 需求 。 通 过 文本 编辑 框 的 
其 他 属性 ,还 可 以 进一步 修改 提示 文本 和 文本 的 字体 、 
颜色 和 字形 ,可 以 设置 文本 编辑 框 是 否 可 编辑 等 。 

在 对 应 用 界面 操作 过 程 中 , 注 设置 为 android: 
inputType 王 "phone" 的 edit_text4 中 输入 文本 时 ,文本 
编辑 框 只 接收 电话 号 码 输入 的 文本 框 , 而 且 软 键盘 也 变 
成 拨号 专用 软 键盘 。 文 本 编辑 框 的 android:inputType 
属性 能 够 设置 为 number、 numberSigned、numberDecimal 
等 不 同 的 值 来 控制 输入 的 数字 类 型 ,分 别 对 应 integer 
( 正 整数 ) ,signed( 带 符号 整数 ) 和 decimal( 浮 点 数 )。 也 


EE 


qwertyuiop 


asdfghjk 1 
从 zxcvbnma 


naa ， 和 二 


图 3.7 文本 编辑 框 的 hint 属性 
对 输入 的 影响 
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可 以 通 过 android:inputType 来 设置 文本 的 类 型 ,让 输入 法 选择 合适 的 软 键盘 ,具体 的 值 
可 以 查 文本 编辑 框 在 http://developer. android. com/reference/android 的 文档 。 

在 android:inputType 属性 设 定 输入 的 文本 类 型 后 , 软 键盘 的 转换 是 自动 的 。 除 了 
这 个 属性 之 外 ,文本 编辑 框 的 android:imeOptions 属性 也 可 以 对 于 软 键盘 进行 控制 , 通 
过 不 同色 代表 不 同 的 值 ,在 回 车 键 的 位 置 显示 出 不 同 的 按钮 ,例如 “完成 ”“ 搜 “去 往 *” 
等 。 下 面 是 android:imeOptions 的 几 个 常用 的 常量 值 ,其 值 不 同 , 软 键 盘 显 示 的 按钮 也 
不 同 。 


actionUnspecified:“ 回 车 ”按钮 。 
actionNone:“ 回 车 ”按钮 。 
actionGo:“ 去 往 ” 按 钮 。 chapter05/EditTextSearch 
actionSearch:“ 搜 索 ” 按 钮 。 
actionSend:“ 发 送 ” 按 钮 。 图 
actionNext:“ 下 一 个 ”按钮 。 图 

actionDone:“ 完 成 ”按钮 。 
除了 输入 和 对 软 键盘 的 控制 之 外 ,文本 编辑 框 对 输 
入 后 的 文本 操作 也 很 灵活 ,Android 为 文本 编辑 框 定义 
了 很 多 处 理 方法 ,能够 实现 取 值 ,全 选 、 部 分 选择 、 获 取 选 加 时 四 加 六 时 时 加 于 
中 文本 。 获 取 文 本 的 操作 在 Java 程序 代码 中 实现 ,由 事 昌国 加 四 加 加 加 园 时 
件 处 理 器 根据 不 同 的 操作 ,对 文本 进行 不 同 的 处 理 。 下 公国 四 回国 四 回 四 所 
面 通过 一 个 例子 来 说 明 如 何 对 文本 编辑 框 输入 的 文本 进 7 : 国 二 
行 取 值 .全 选 .部 分 选择 和 获取 选中 文本 ,如 图 3. 8 所 示 。 
具体 地 实现 代码 3. 16 和 代码 3. 17 内 容 。 

代码 3. 16 edittext_search 


3.8 文本 编辑 框 界面 


< ?aml version= "1.0" enooding= "utf- 8"?> 

< LinearTayout. xmlns:androidF "http://schemas.android.om/apk/res/android" 
android:layout width= "fil] parent™ 
android:layout height= "fil1 parent" 
android:orientation= "vertical"> 


< EditText 
android:idF "@ + id/edit text" 
android: layout width= "fill parent" 
android: layout. height= "wrap_oontent" 
android:inputType= "text™" 
android:imeOptions= "actionSearch"/> 


< Button 
android:id- "@ + id/bin get value" 
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代码 3.17 EditTextSearchActivity. java 
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/获取 选中 的 文本 
Buttcn getSelect= (Button) findViewById(R.id.bin get select); 
getSelect .setOnClickListener (new OnClickListener() { 
@ Override 
piblic void onclick (View v) { 
int start= FditText .getSelectionStart (); 
int end= EditText .getSelectionEnd(); 
CharSequence selectText= FditText .getText () 
.SubSequence (start, end); 
Toast .makeText (EditTextSearchActivity.this, selectText, 
Toast.IENGTH SHORT) .show(); 


3.3 界面 效果 处 理 


Android 的 API 中 提供 了 一 些 特殊 的 界面 效果 处 理 方法 ,下 面 介绍 这 些 方法 。 
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在 Android 中 ,有 时 候 需 要 对 文本 进行 各 种 特别 的 设置 ,例如 颜色 、 大 小 、 首 行 缩 进 ， 
或 者 是 在 一 段 文 本 中 加 入 图 片 ,甚至 是 书写 一 些 特殊 的 公式 。 如 果 通 过 布局 文件 使 用 多 
个 控件 来 实现 ,一 方面 会 使 用 起 来 特别 复杂 ,增加 了 布局 文件 维护 的 难度 ; 另 一 方面 ,如 果 
加 入 了 太 多 的 控件 ,在 页 面 加载 时 也 要 耗费 更 多 的 资源 。 在 HTML 中 ,可 以 使 用 各 种 标 
签 来 实现 这 些 特 殊 效 果 ,而 在 Android 中 有 类 似 的 机 制 , 只 不 过 不 是 使 用 标签 来 实现 ,而 
是 使 用 Spannable 对 象 来 实现 。 

1. 定义 链接 

在 传统 的 HTML 中 网 页 中 ,加 一 个 二 a 二 标记 就 可 以 让 一 段 文字 变 成 超 链接 的 形 
式 , 可 以 单 击 到 连接 的 地 址 。 在 Android 界面 中 也 能 提供 类 似 的 功能 。Android 界面 的 
大 多 数 文本 一 般 通 过 文本 显示 框 对 象 来 显示 ,文本 显示 框 的 android:autoLink 属性 设置 
可 以 实现 这 个 功能 。 如 果 某 个 文本 显示 框 的 android:autoLink 属性 设置 成 web, 则 该 文 
本 显示 框 中 网 址 形式 的 字符 就 会 自动 变 成 超 链接 的 形式 。 下 面 使 用 一 个 简单 的 例子 来 说 
明 设置 的 过 程 。 

首先 在 /res/values/String. xml 中 定义 一 个 字符 串 , 见 代码 3. 18。 

代码 3.18 定义 字符 串 资源 


< string name= "tadbao Moommeroe _android"> 移动 电子 商务 开发 实践 : http://code.google.com/p/ 
tacbao- sdk— for- android- platform/< /string> 
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然后 ,在 /res/layout/main. xml 布局 文件 中 ,把 文本 显示 框 的 android:autoLink 属性 
设置 成 web, 见 代码 3. 19 。 
代码 3.19 设置 TextView 的 链接 属性 


< ?aml version= "1.0" enooding= "utf— 8"2?> 
< LinearTayout 3mlns:android- "http://schemas.android.om/apk/res/android" 
android:layout widthr "fil] parent" 
android:layout height= "fill parent" 
android:orientation= "vertical"> 


< TextView 
android:id= "@ + id/textView" 
android: layout. width= "fill parent" 
android: layout. height= "wrap content" 
android:autoLink= "web" 
android:text= "@ string/tacbao Moammerce android" 
android:textColor= 啡 ff0000" 
android:textSize= "24sp" 
android:textStyle= "bold"/> 


< /LinearTayout> 


android:autoLink 的 值 还 可 以 是 phone 或 email, 可 以 将 字符 串 中 的 电话 或 邮件 地 址 
设置 成 超 链接 ,如 果 将 这 个 值 设置 为 all, 则 对 上 述 三 种 类 型 的 字符 串 都 设置 成 超 链接 。 

2. 文本 样式 

有 了 时候, 需要 对 文本 显示 的 样式 进行 一 些 特殊 的 设置 .例如 突出 显示 视图 中 部 分 内 
容 , 可 以 使 用 Android 的 文本 样式 设置 来 完成 。Android 的 文本 设置 样式 可 以 使 用 静态 
或 动态 方式 设置 内 容 的 样式 两 种 方式 。 

(1) 静态 方式 设置 文本 样式 : 静态 的 方式 是 直接 在 /res/values/string. xml 中 定义 一 
个 字符 串 变 量 , 并 指定 其 内 容 , 如 下 所 示 : 


< string name= "styledText"> 在 <b> TextView< /by> 中 设置 < 这 静态 < /了 > 样式 
< /string> 


字符 串 定义 好 后 ,就 可 以 在 XML 布局 文件 或 应 用 程序 代码 中 引用 这 个 字符 串 资源 
了 。 在 字符 串 定义 时 ,可 以 使 用 XML 的 标签 。 例 如 ,过 i>、 二 b 二 和 二 u 二 分 别 代 表 斜 
体 . 加 粗 和 下 划 线 ,还 可 以 使 用 二 sup 二 .二 sub 二 .一 strike 二 一 big 二 一 small 二 和 
所 monospace 盖 等 标签 。 这 些 标 签 不 仅 可 以 作用 在 TextViews 上 ,而 且 对 其 他 View 也 起 
作用 。 

使 用 Activity 导入 代码 3. 20 中 的 布局 文件 ,查看 显示 内 容 可 知 , 在 字符 串 中 定义 的 
格式 效果 会 完全 显示 出 来 。 
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代码 3.20 带 样 式 的 布局 文件 


(2) 动态 方式 设置 文本 样式 : 动态 方式 设置 文本 样式 ,也 就 是 通过 应 用 程序 代码 编 
程 的 方式 来 设置 或 改变 TextView 中 的 显示 内 容 的 格式 。 这 种 方式 比 静 态 方式 要 复杂 ， 
但 是 更 具 灵 活性 。 

如 果 要 动态 设置 文本 样式 ,首先 要 将 TextView 中 显示 的 内 容 设 置 为 Spanable 对 象 ， 
代码 如 下 : 


通过 上 面 的 设置 , TextView 中 的 内 容 被 存储 成 Spannable 对 象 ,然后 就 可 以 使 用 
TextView 的 getText() 方 法 获取 Spannable 对 象 。 有 具体 获取 Spannable 对 象 的 代码 
如 下 : 


也 可 以 先 创 建 一 个 SpannableString 对 象 , 然 后 使 用 TextView 的 setText() 方 法 将 
这 个 对 象 传递 给 TextView ,代码 如 下 : 


获取 或 创建 Spannable 对 象 以 后 ,就 可 以 使 用 Spannable 类 提供 的 setSpan (Obj 
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what,int start,int end,int flags) 方 法 来 进行 样式 的 设置 。setSpan() 方 法 的 参数 说 明 如 
下 : what 是 具体 样式 对 象 , 所 实现 的 类 都 在 android. text. style 包 中 ;start 则 是 该 样式 开 
始 的 位 置 ;end 对 应 的 是 样式 结束 的 位 置 ;参数 flags, 定 义 在 Spannable 中 的 常量 ,常用 
的 有 : 

(1) Spanned. SPAN_EXCLUSIVE_EXCLUSIVE: 不 包含 两 端 start 和 end 所 在 的 
端点 ,可 表示 为 (a,b)。 

(2) Spanned. SPAN_EXCLUSIVE_INCLUSIVE: 不 包含 端 start, 但 包含 end 所 在 
的 端点 ,可 表示 为 (a,bj]。 

(3) Spanned. SPAN_INCLUSIVE_EXCLUSIVE: 包含 两 端 start, 但 不 包含 end 所 
在 的 端点 ,可 表示 为 [a,b)。 

(4) Spanned. SPAN_INCLUSIVE_INCLUSIVE: 包含 两 端 start 和 end 所 在 的 端 
点 ,可 表示 为 [a,b]。 

例如 ,设置 文本 字符 串 的 第 2、3 个 字符 显示 为 粗 斜体 的 代码 如 下 : 


msp.setSpan (new StyleSpan (android.graphics.Typeface.BOLD TTALIC), 
0, 4, Spannable.SPAN FXCIUSIVE FXCIUSIVE); 


与 StyleSpan 类 具有 类 似 作 用 ,用 来 构建 样式 的 其 他 类 都 在 android. text. style 包 
下 ,其 中 还 包括 : 

(1) AbsoluteSizeSpan: 是 指 绝 对 尺寸 ,通过 指定 绝对 尺寸 来 改变 文本 的 字体 大 小 。 

(2) BulletSpan: 着 重 样式 ,类 似 于 HTML 中 的 二 li 一 标签 的 圆 点 效果 。 

(3) ForegroundColorSpan: 字体 颜色 样式 ,用 于 改变 字体 颜色 。 

下 面 代码 3. 21 中 示例 了 使 用 了 动态 方式 设置 一 个 字符 串 中 不 同 字符 不 同样 式 的 
用 法 。 

代码 3.21 设置 文本 外 观 


Public class SpannableActivity extends Activity { 
@ Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanoeState) ; 
SetContentView (R.laycut.c03 spannable); 
TextView tv3 (TextView) this.findViewById (R.id.tv3); 
tv3.setText ( 呐 认 、35 像 素 ,默认 一 半 ,默认 两 倍 \n" + 
吗 景 色 、 背 景色 \n"+ "正常 、 粗 体 、 斜 体 、 粗 斜体 \n"+ 
" 吓 划 线 、 删 除 线 \n"+ "下 标 、 上 标 \n" + 
虽 话 邮件、 网址 \nr+ 顺 目 符号 "， 
TextView.BufferType.SPANNABIE) ; 
Spannable spn= (Spannable) tv3.getText (); 
// 设 置 字体 (Gefault, default- bold,monospace, serif, sans- serif) 
spn-setSpan (new TypefaceSpan ("Imonospace"), 0, spn-length(), 
Spanned.SPAN FXCIUSIVE EXCIUSIVE); 
// 设 置 字体 大 小 绝对 值 , 单 位 : 像素 ) 


加 二 
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运行 SpannableActivity. java, 运 行 效果 如 图 3.9 所 示 。 


图 3.9 不 同文 本 样式 的 显示 结果 
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Android 的 视图 对 象 在 应 用 过 程 中 ,存在 不 同 的 状态 。 例 如 按钮 ,具有 单 击 按 下 、 获 
得 焦点 或 正常 情况 等 状态 。 根 据 控件 的 状态 ,StateListDrawable 对 象 可 以 使 用 几 种 不 同 
的 图 像 来 为 控件 指定 背景 图 片 ,这 称 为 切换 绘图 。 实 现 切换 绘图 有 两 种 方式 : XML 文件 
定义 和 应 用 程序 定义 。 

1. 使 用 XML 文件 定义 状态 选择 列表 

- 般 来 说 ,首先 要 使 用 XML 文件 定义 状态 选择 列表 。 这 个 文件 需要 创建 在 res 目录 
下 的 drawable 文件 夹 中 。 在 一 个 XML 状态 列表 文件 中 只 有 一 个 二 selector 二 元 素 , 其 中 
包含 多 个 二 item 放 元 素 ,用 来 定义 状态 及 其 对 应 的 图 片 。 代 码 3. 22 中 示例 了 一 个 状态 列 
表 定义 的 语法 。 

代码 3.22 ”状态 选择 列表 定义 


< ?ml versior= "] .0" encodingF "utf- 8"?> 
< selector xmlns:android- "http://schemas.android.caapky/res/android"> 
< item android:state pressed= "true" 
android:drawable= "@ drawable/button pressed"/>< !- -pressed- -> 
< item android:state focused= "true" 
android:drawable= "@ drawable/button focused"/> < !- - focused- -> 
< item android:state hovered= "true" 
android:drawable= "@ drawable/button focused"/>< !- - hovered- -> 
< item android:drawable= "@ drawable/button nomal"/>< !- ~ default—- 一 > 
< /selector> 


二 item 记 元 素 通过 属性 定义 显示 图 片 时 的 状态 。 代 码 3. 22 定义 了 4 种 状态 ,其 中 
包括 : 

(1) android:state_pressed: 其 值 为 布尔 型 ,如 果 为 true, 当 对 象 被 按 下 (例如 触摸 / 单 
击 一 个 按钮 ) 使 用 此 选项 ;如 果 为 false, 当 处 于 没有 按 下 状态 时 ,默认 设置 使 用 此 选项 。 

(2) android:state_focused: 其 值 为 布尔 型 ,如果 为 true, 当 对 象 拥有 输入 焦点 时 应 使 
用 此 选项 (例如 当 用 户 选择 一 个 文本 输入 ) 使 用 此 选项 ;如 果 为 false, 当 处 于 没有 焦点 状 
态 时 ,默认 设置 使 用 此 选项 。 

(3) android:state_hovered: 其 值 为 布尔 型 ,如 果 为 true, 当 游标 悬浮 在 对 象 之 上 时 ， 
使 用 此 选项 ;如 果 为 false, 不 是 处 于 游标 悬浮 状态 ,默认 使 用 此 选项 。 通 常 , 这 种 此 选项 
使 用 的 图 片 与 焦点 状态 的 选项 相同 。 
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(4) 最 后 一 个 选项 是 默认 状态 。 当 控件 的 状态 发 生变 化 时 , Android 会 从 第 一 个 
二 item 记 元 素 开始 查找 ,匹配 当前 状态 的 二 item 二 元 素 被 选中 ,这 种 选择 不 是 基于 最 佳 匹 
配 的 方式 ,只 要 求 符合 当前 状态 的 最 低 标准 。 二 item 记 元 素 使 用 android: drawable 属性 
指定 一 个 图 片 资 源 , 这 个 属性 是 必要 的 。 

假设 代码 3. 22 定义 的 状态 选择 列表 文件 名 为 button_bg. xml, 在 布局 文件 中 可 以 直 
接 引 用 代码 3. 22 定义 的 资源 , 见 代 码 3. 23。 

代码 3.23 引用 状态 列表 


2. 在 应 用 程序 中 实现 切换 绘图 
也 可 以 使 用 编码 的 方式 实现 上 面 的 功能 ,具体 实现 如 代码 3. 24 所 示 。 
代码 3.24 使 用 代码 实现 绘图 切换 
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bg.addState (View.FNABLED FOCUSED STATE SET, selected); 
bg.addState (View.FNABIED STATE SET，normal)7 
bg.adtistate (View.FOCUSED STATE SET, selected); 
bg.addstate (View-EMPTY STATE SET，normal)7 

retum bg; 


} 
除了 Button 之 外 ,还 可 以 用 类 似 的 方式 给 其 他 的 视图 对 象 指定 不 同 状态 的 背景 。 
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在 用 户 界面 显示 图 形 或 图 像 时 ,使 用 LayerDrawable 对 象 可 以 将 多 个 绘图 资源 按照 
顺序 重生 起 来 ,最 后 一 个 绘图 资源 将 会 被 放 在 最 上 面 ,呈现 出 释 加 视图 的 效果 。 实 现 秋 加 
视图 ,同样 可 以 通过 两 种 方式 来 实现 : XML 文件 和 应 用 程序 代码 。 

LayerDrawable 可 以 通过 XML 文件 定义 ,这 个 XML 文件 需要 保存 在 res/ drawable/ 
文件 夹 中 。 其 根 元 素 为 二 layer-list 二 ,其 中 包含 多 个 二 item 二 子 元 素 , 代 码 3. 25 是 一 个 
定义 全 加 绘图 资源 的 XML 文件 例子 。 

代码 3.25 定义 全 加 绘图 资源 


< ?ml versior= "] .0" encodingF "utf- 8"?> 
< layer- list xmlns:android= "http://schemas.android.oo/apk/res/android"> 
< item> 
<bitmap android:src= "@ drawable/android red" 
android:gravity= "canter"/> 
< /iter> 
< item android:top= "10dp" android:left= "10dp"> 
< bitmap android:src= "@ drawable/android green" 
android:gravity= "Canter"/> 
< /iter> 
< item android:top= "20dp" android:left= "20dp"> 
< bitmap android:src= "@ drawable/android blue" 
android:gravity= "oanter"/> 
< /iter> 
< /layer- list> 


代码 3. 25 定义 了 三 个 绘图 资源 的 又 加 ,最 后 定义 的 绘图 资源 显示 在 最 上 面 。<item 放 
元 素 可 以 定义 绘图 资源 在 4 个 方向 的 偏 移 量 , 其 属性 分 别 为 android:left、android: right、 
android:top 和 android:bottom。 在 默认 情况 下 ,所 有 的 绘图 
资源 都 会 发 生 缩放 以 适应 包含 其 容器 的 尺寸 。 假 设 代码 3. 25 
文件 名 为 image_layers. xml, 在 布局 文件 中 ,可 以 在 定义 一 个 
ImageButton 时 引用 , 见 代 码 3. 26 。 显 示 效 果 如 图 3. 10 所 示 。 图 3.10 友 加 绘图 结果 显示 
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代码 3.26 引用 图 形 又 加 资源 


图 3. 10 的 效果 也 可 以 通过 应 用 程序 代码 来 实现 ,在 Activity 的 onCreate() 方 法 中 添 
加 设置 释 加 视图 的 语句 ,如 代码 3. 27 所 示 。 
代码 3.27 在 应 用 程序 中 设置 到 加 绘图 


BitmapDrawable dl= (BitmapDrawable) getResources () .getDrawable( 
R.drawable.android) ; 

dl .setGravity (Gravity.CENIER); 

BitmapDrawable d2= (BitmapDrawable) getResources () .getDrawable( 
R.drawable.android focused); 

dl .setGravity (Gravity.CENIER); 

BitmapDrawable d3- (BitmapDrawable) getResources () .getDrawable( 
R.drawable.android pressed); 

d3.3etGravity (Gravity.CENIER); 

Drawable drawableArray[]= new Drawable[] { dl, dz, d3 }; 

LayerDrawable layerDraw= new LayerDrawable (drawableArray); 

LayerDraw. setLayerInset (1, 10, 10, 0, 0); //set offset of 2 layer 

IayerDraw.setLayerInset (2, 20, 20, 0, 0); //set offset for third layer 

ImageView imageView= (ImageView) fincViewById(R.id.imView); 

IrmageView. set ImageDrawable (layerDraw) ; 
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Android 的 视图 对 象 不 仅 可 以 根据 状态 定义 切换 的 图 形 , 还 可 以 定义 切换 的 颜色 。 
根据 控件 的 状态 ,Android 使 用 ColorStateList 对 象 可 以 为 控件 定义 几 种 不 同 的 颜色 。 同 
样 ,定义 切换 的 颜色 可 以 有 使 用 XML 文件 定义 和 程序 代码 实现 两 种 方式 。 

切换 颜色 的 状态 列表 也 是 通过 XML 文件 定义 的 方式 ,与 实现 切换 图 片 效 果 的 方式 
类 似 , 都 是 通过 二 selector 王 和 二 item 记 元 素来 定义 的 。 不 同 的 之 处 是 切换 颜色 必须 定义 
二 item 记 的 android:color 属性 ,其 属性 值 为 十 六 进 制 颜色 ,使 用 RGB 值 来 指定 ,并 且 可 
以 选择 alpha 通道 。RGB 值 始 终 使 用 上 字符 开头 ,后 面 跟 Appha-Red-Green-Blue 信息 ， 
格式 可 以 为 RGB、#ARGB、#RRGGBB 和 并 AARRGGBB。 例 如 ,代码 3. 28 定义 了 三 
种 状态 和 对 应 的 三 种 颜色 。 
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代码 3.28 定义 三 种 状态 和 颜色 


另 一 个 与 切换 绘图 设置 不 同 之 处 在 于 ,XML 定义 文件 的 位 置 位 于 res/color/ 文 件 夹 
中 。 假 设 代 码 3. 28 的 文件 名 为 edittext _color. xml, 如 果 要 在 布局 文件 中 的 两 个 
EditText 控件 引用 了 这 个 资源 文件 ,直接 使 用 android:textColor 属性 。 具 体 引用 语法 见 
代码 3. 29 。 

代码 3.29 在 布局 文件 中 引用 


创建 一 个 例子 Activity, 导 入 代码 3. 29 定义 的 布局 资源 文件 ,尝试 分 别 单 击 这 两 个 
EditText, 查 看 改变 焦点 后 文本 颜色 会 发 生 什么 变化 。 


3.4 小 结 


本 章 主要 介绍 了 Android 用 户 界面 的 事件 处 理 机 制 。Android 的 事件 处 理 机 制 有 两 
种 ,基于 监听 接口 和 基于 回调 机 制 。 基 于 监听 接口 的 事件 处 理 机 制 ,完全 采用 了 Java 基 
于 委托 事件 处 理 模型 。 在 实现 事件 处 理 时 ,基于 监听 器 的 事件 处 理 做 3 个 工作 : 定义 监 
听 器 类 ,覆盖 对 应 的 抽象 方法 ,在 监听 器 中 针对 事件 编写 响应 的 处 理 代码 ;创建 监听 器 对 
象 ;注册 监听 器 。 基 于 回调 机 制 的 事件 处 理 机 制 , 采 用 Android 系统 为 每 个 组 件 预 定义 好 
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的 对 应 事件 处 理 方法 , 称 为 回调 方法 。 在 实现 事件 处 理 时 ,基于 回调 方法 的 事件 处 理 只 需 
要 覆盖 相应 的 回调 方法 ,在 其 中 编写 事件 处 理 代码 。 

本 章 的 另 一 部 分 的 主要 内 容 主要 介绍 了 Android 用 户 界面 的 一 些 常 用 控件 和 界面 效 
果 处 理 。 对 于 常用 控件 ,使 用 简单 的 例子 说 明了 按钮 控件 .Toast 和 文本 控件 控件 的 使 
用 ,包括 它们 的 布局 .属性 以 及 基于 监听 接口 的 事件 处 理 机 制 ;界面 效果 处 理 部 分 ,说 明了 
文本 特殊 格式 切换 绘 图 、 秋 加 绘图 和 切换 颜色 如 何 通 XML 文件 和 应 用 程序 来 实现 。 
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设计 应 用 程序 的 浏览 模式 是 完善 用 户 体验 需要 考虑 的 重要 一 环 。 如 果 浏 览 模式 设计 
的 不 佳 ,用 户 无 法 快速 定位 所 需 的 功能 ,或 者 出 现 错误 定位 使 用 户 无 法 得 到 所 需 的 功能 ， 
这 些 都 会 产生 不 好 的 用 户 体 验 。 从 Android 3.0 开始 ,Android 系统 的 应 用 浏览 模式 发 生 
了 较 大 的 改变 ,引入 了 向 上 和 返回 的 设计 原则 ,并且 提 供 了 相应 的 设计 组 件 ,其 中 包含 菜 
单 .动作 条 和 浏览 抽 居 等 。 如 果 要 实现 准确 的 ,一 致 的 应 用 程序 浏览 ,还 需要 理解 浏览 模 
式 的 原则 ,并 且 学 会 组 件 的 使 用 。 


4.1 菜单 模式 


在 Android 中 ,支持 菜单 视图 元 素 的 关键 类 是 android. view. Menu, 每 个 Activity 都 
会 关联 一 个 这 种 类 型 的 菜单 对 象 。 一 个 菜单 对 象 包 含 了 一 些 菜单 项 和 子 菜单 。 菜 单项 由 
android. view. Menultem 类 表示 , 子 菜单 由 android. view. SubMenu 类 表示 。 菜 单项 具有 
的 属性 包括 名 称 .菜单 项 ID、 分 组 ID ,顺序 等 。 

菜单 的 定义 与 用 户 界面 的 其 他 可 视 控 件 类 似 , 可 以 通过 XML 文件 定义 菜单 资源 , 保 
存在 res 目录 下 的 menu 文件 夹 中 ,在 Java 程序 中 可 以 通过 ID 来 获取 定义 的 对 象 ,进行 
操作 。 定 义 菜单 资源 的 语法 见 代码 4. 1。 

代码 4.1 定义 菜单 资源 的 语法 


< ?ml version= "] .0" encodingF "utf- 8"2> 
<menu xmlns:androidF "http://schemas.android.camapky/res/android"> 
< item android:id= "@ [+ ] [backage:]iq/resource name" 
android:title= "string" 
android:titleCondensed= "string" 
android:icon= "@ [package:]drawable/drawable resouroe name" 
android:conClick= "method name" 
android: showAsAction= ["ifRom"| "never"| "withText"| "always"| 
"oollapseActionView"] 

android:actionLayout— "@ [package:]layout/layout. resouroe name" 
android:actionViewClass= "class name™ 
android:actionProviderClass= "Class name" 
android:alphabeticshortout— "string" 
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android:numericShortcut= "string"” 
android:checkable= ["true"| "false"] 
android:visible= ["true"| "false"] 
android:enabled= ["true"| "false"] 
androidmen Category= ("oantainer"| "systert"| "seondary"| "altemative"] 
android:orderInCategory= "integer"/> 
< group android:id= "@ [+ ] [package:]id/resouroe name" 
android:checkableBehavior= ["none"| "all"| "single"] 
android:visible= ["true"| "false"] 
android:enabled= ["true"| "false"] 
android:menuCategory= ["container"| "system"| "seoondary"| 
"altemative"] 
android:orderInCategory= "integer"> 
< item/> 
</group> 
< item> 
<menu> 
< ite/> 
< /menn> 
< /item> 
< /menn> 
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对 于 所 有 类 型 的 菜单 ,Android 提供 了 标准 的 XML 格式 来 定义 菜单 项 ,所 以 除了 在 
代码 中 实例 化 菜单 之 外 ,还 可 以 在 一 个 XML 菜单 资源 中 定义 菜单 和 菜单 项 ,然后 在 
Activity 中 使 用 资源 ID 加 载 菜单 资源 。 使 用 XML 资源 来 定义 菜单 是 一 种 推荐 的 方式 。 
使 用 XML 资源 来 定义 菜单 有 许多 优点 ,例如 可 以 更 好 地 体现 菜单 的 结构 ,可 以 使 逻辑 代 
码 和 菜单 内 容 分 离 ,可 以 为 不 同 的 平台 版 本 ,不 同 的 屏幕 尺寸 等 提供 可 以 蔡 换 的 菜单 配 
置 。 代 码 4. 1 给 出 了 使 用 XML 文件 定义 菜单 资源 的 示例 ,下 面 针 对 XML 文件 定义 菜单 
资源 时 使 用 的 元 素 进行 说 明 。 

(1) 二 menu>: 此 元 素 用 来 定义 菜单 ,用 来 包含 菜单 项 。 必 须 有 一 个 二 menu 二 元 素 
作为 菜单 资源 XML 文件 的 根 元 素 , 其 中 可 以 包含 一 个 或 多 个 二 item 之 和 二 group 二 
元 素 。 

(2) 一 item 二 : 此 元 素 用 来 定义 菜单 项 ,每 个 二 item 二 都 表示 一 个 菜单 项 ,而 且 其 还 
可 以 包含 一 个 内 岩 的 二 menu 一 元 素 , 用 来 创建 子 菜单 。 

(3) 一 group 二 : 此 元 素 是 一 个 可 选 的 .不 可 见 的 ,可 以 用 来 对 菜单 项 进行 分 类 ,目的 
是 使 它们 可 以 共享 相同 的 属性 ,例如 激活 状态 和 可 见 性 。 

另外 ,经 常 使 用 下 面 几 种 二 item 记 元 素 属性 来 定义 菜单 项 的 显示 和 行为 : 

(1) android:id: 表示 菜单 项 的 唯一 资源 ID, 用 来 识别 菜单 项 。 

(2) android:icon: 表示 菜单 项 的 显示 图 标 , 可 以 指定 一 个 图 片 资源 。 
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(3) android:title: 表示 菜单 项 的 显示 标题 ,这 里 指定 一 个 字符 串 资源 。 

例如 ,代码 4. 2 定义 了 一 个 简单 的 菜单 资源 XML 文件 game_menu. xml, 其 中 使 用 
了 二 menu 记 和 二 item 记 元 素 的 一 些 属性 。 

代码 4.2 简单 的 菜单 资源 文件 


< ?xml version= "1.0" encoding= "utf— 8"2?> 
< menu xmlns:android= "http://schemas.android.cayapk/res/android"> 
< item android:id= "@ + id/new game" 
android:ioon= "@ drawable/ic new game" 
android:title= "@ string/new game" 
android:showAsAction= "ifRocm"/> 


< item android:id= "@ + id/help" 
android:ioon= "@ drawable/ic help" 
android:title= "@ string/help"/> 
< /menu> 
如 果 需 要 增加 子 菜单 ,需要 在 一 item 二 元 素 中 包含 二 menu 二 元 素 , 子 菜单 可 以 起 到 


将 应 用 程序 功能 按照 主题 进行 分 类 的 作用 。 例 如 ,在 Microsoft Office 套件 应 用 的 菜单 条 
中 都 有 "文件 " “编辑 "等 子 菜单 。 

子 菜单 中 菜单 选项 的 定义 与 菜单 类 似 , 元 素 和 属性 的 应 用 也 相同 ,代码 4. 3 给 出 了 使 
用 XML 资源 文件 定义 子 菜单 的 简单 例子 。 

代码 4.3 使 用 XML 文件 定义 子 菜单 


< ?ml version= "1.0" enooding= "utf- 8"?> 
< menu xmlns:android= "http://schemas.android.com/apk/res/android"> 
< item android:id= "@ + id/file" 
android:title= "@ string/file"> 
<!-—-"file" smenmnr- 一 > 
<menu> 
< item android:id- "@ + id/create new" 
android:title= "@ string/create new"/> 
< item android:id= "@ + id/open" 
android:title= "@ string/open"/> 
< /menu> 
< /item> 
< frenu> 


菜单 项 目 在 菜单 列表 的 排列 顺序 由 android: orderInCategory 和 android: 
menuCategory 两 个 属性 值 之 和 确定 的 。 数 值 之 和 越 小 排列 越 靠 前 ,表示 更 重要 。 例 如 ， 
一 个 菜单 项 排列 顺序 为 4 和 另 一 个 菜单 项 排列 顺序 数 为 6, 如 果 为 列表 形式 排列 的 菜单 ， 
第 一 个 菜单 项 将 出 现在 第 二 个 菜单 项 的 上 面 ; 如 果 为 6 项 形式 排列 的 菜单 ,第 一 个 菜单 项 
将 出 现在 第 二 个 菜单 项 的 左边 。android: menuCategory 被 称 为 菜单 类 别 属 性 ,包含 了 4 
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(1 ) continer: 表示 菜单 类 别 从 0x10000 开始 ,由 常量 Menu. CATEGORY _ 
CONTAINER 定义 。 

(2) system: 表示 菜单 类 别 从 0x20000 开始 ,由 常量 Menu. CATEGORY_SYSTEM 
定 光 5 

(3) secondary: 表示 菜单 类 别 从 0x30000 开始 ,由 常量 Menu. CATEGORY _ 
SECONDARY 定义 。 

(4) alternative: 表示 菜单 类 别 从 0x40000 开始 ,由 常量 Menu. CATEGORY _ 
ALTERNATIVE 定义 。 

如 果 要 将 定义 好 的 菜单 资源 加 载 到 Activity 中 ,需要 使 用 Menulnflater. inflate() 方 
法 ,在 下 面 的 章节 中 ,介绍 每 种 菜单 的 加 载 方式 。 


412 菜单 类 型 


Android SDK 支持 丰富 的 菜单 类 型 ,包括 常规 的 菜单 、 子 菜单 、 上 下 文 菜单 .图 标 菜 
单 、 二 级 菜单 和 替代 菜单 。 此 外 , Android 3. 0 推出 了 动作 条 ,可 以 与 菜单 进行 交互 。 
Android 4.0 已 经 推出 弹出 式 菜单 ,可 以 随时 响应 按钮 单 击 或 任何 其 他 UI 事件 。 

Android SDK 提供 的 菜单 有 如 下 3 种 基本 类 型 。 

(1) 选项 菜单 : 选项 菜单 是 一 个 Activity 菜单 项 的 主要 集合 ,如 果 在 这 里 加 入 操作 ， 
将 会 影响 应 用 程序 的 全 局 。 如 果 使 用 Android 2. 3 或 者 之 前 的 SDK 版 本 开发 ,用 户 可 以 
使 用 菜单 键 打开 选项 菜单 ,但 是 对 于 Android 3. 0 或 者 更 高 的 版 本 来 说 ,选项 菜单 中 的 菜 
单项 目 是 通过 动作 条 与 其 他 屏幕 动作 项 目 一 起 展现 的 。 从 Android 3. 0 开始 ,一 些 设备 
已 经 不 支持 菜单 键 , 需 要 使 用 动作 条 来 开发 应 用 。 

(2) 上 下 文 菜单 : 当 用 户 长 按 某 个 视图 或 视图 元 素 后 出 现 的 浮动 菜单 ,菜单 中 包含 
的 动作 是 与 用 户 所 选择 视图 元 素 相 关 的 。 在 Android 3. 0 和 更 高 版 本 上 进行 开发 ,可 以 
在 选 定 的 内 容 上 使 用 上 下 文 操作 模式 ,显示 相应 的 操作 。 这 种 模式 在 屏幕 上 方 的 操作 条 
中 显示 影响 所 选 的 内 容 的 操作 项 ,并 允许 用 户 选择 多 个 项 目 。 

(3) 弹出 菜单 : 弹出 菜单 被 固定 在 调用 菜单 的 视图 元 素 上 ,并 且 在 一 个 垂直 列表 中 
显示 菜单 项 目 。 

在 Android 中 ,这 些 菜单 都 可 以 在 XML 资源 文件 中 定义 ,并 通过 菜单 资源 文件 中 的 
ID 加 载 到 Java 程序 中 。 

1. 选项 菜单 

在 Android SDK 中 ,由 于 每 个 Activity 都 会 关联 一 个 菜单 ,所 以 不 需要 从 头 开始 创 
建 一 个 菜单 对 象 。Android 的 菜单 创建 ,具体 是 由 Activity 的 onCreateOptionsMenu() 回 
调 方 法 来 实现 的 ,选项 菜单 的 创建 也 可 以 由 这 个 回调 方法 来 实现 。 

选项 菜单 中 包含 的 动作 和 选项 与 当前 Activity 上 下 文 相关 ,并且 根 据 Android 系统 
版 本 的 不 同 , 其 显示 的 位 置 也 不 同 。 如 果 使 用 Android 2. 3. x(API level 10) 或 者 更 低 的 
版 本 , 当 用 户 按 菜单 键 时 ,选项 菜单 的 内 容 显 示 在 屏幕 的 底部 ,可 以 最 多 显示 6 个 带 有 图 
标 按 钮 的 无 滚动 条 窗 体 ;如 果菜 单项 超过 6 个 就 需要 使 用 扩展 菜单 项 ,这样 这 个 窗 体 的 最 
后 一 个 按钮 变 成 了 More, 选 中 后 会 弹出 一 个 包含 多 个 菜单 项 的 列表 ,可 能 还 带 有 滚动 条 ， 
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如 图 4.1 所 示 为 Android 2. 3. x 的 选项 菜单 界面 。 
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菜 扩展 选项 菜单 
图 4.1 Android 2.3.x 选项 菜单 界面 


如 果 使 用 Android 3. 0(API level 11) 或 者 更 高 的 版 本 ,用 户 可 以 在 动作 条 中 使 用 选 
项 菜单 的 菜单 项 。 默 认 情况 下 ,系统 将 所 有 的 
菜单 项 作为 动作 条 的 溢出 操作 ,用 户 可 以 单 击 
动作 条 最 右边 的 溢出 操作 图 标 显示 没有 显示 
的 菜单 项 ;如 果 手 机 有 菜单 键 ,对 于 不 在 动作 
条 中 显示 的 菜单 项 ,用 户 按 菜单 键 则 会 看 到 剩 
余 的 菜单 项 。 如 图 4. 2 所 示 为 Android 3.0 的 
选项 菜单 界面 。 图 4.2 Android 3.0 以 上 选项 菜单 界面 

选项 菜单 选项 既 可 以 在 Activity 中 声明 ， 

也 可 以 在 男 一 种 更 灵活 的 图 形 组 件 Fragment 中 声明 。 如 果 Activity 和 Fragment 都 为 
选项 菜单 声明 了 菜单 项 ,而 且 合 并 在 UI 界面 中 ,那么 Activity 中 的 菜单 项 优先 显示 , 然 
后 才 按 顺序 把 Fragment 中 菜单 项 添加 到 Activity 中 。 如 果 要 设 定 菜单 项 的 顺序 ,也 可 以 
在 二 item 二 元 素 中 添加 android:orderInCategory 的 属性 ,重新 按 次 序 添加 菜单 项 。 

在 Activity 中 ,通过 覆盖 其 onCreateOptionsMenu() 方 法 来 指定 选项 菜单 ,具体 实现 
加 载 菜单 ;在 Fragment 中 ,也 是 覆盖 其 onCreateOptionsMenu() 方 法 ,通过 菜单 资源 中 定 
义 的 菜单 ID ,获取 菜单 对 象 ,赋值 给 声明 的 菜单 类 变量 , 见 代码 4. 4。 

代码 4.4 在 onCreateOptionsMenu() 方 法 中 获取 菜单 对 象 


@ Override 

public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater= getMenuInflater()7 
inflater.inflate (R.menu.game menu, menu); 
retum true; 

1 


在 代码 4. 4 中 ,getMenuInflater() 方 法 返回 了 一 个 MenuInflater 对 象 , 用 此 对 象 来 调 
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用 inflate() 方 法 ,将 菜单 资源 填充 到 菜单 对 象 中 。 一 旦 菜单 项 被 加 载 , onCreate- 
OptionsMenu() 方 法 应 该 返回 true, 使 菜单 可 见 。 如 果 此 方法 返回 false, 菜 单 是 不 可 见 
的 。 对 于 Android 2. 3. x 和 更 低 的 版 本 来 说 ,这 个 方法 是 在 用 户 第 一 次 打开 菜单 的 时 候 
由 系统 执行 的 ;而 对 于 Android 3. 0 和 更 高 的 版 本 来 说 ,由 于 要 在 动作 条 中 显示 菜单 项 ， 
系统 在 启动 Activity 时 就 调用 此 方法 。 
在 Android 应 用 程序 中 ,也 可 以 使 用 Menu 类 提供 的 add() 方 法 动态 增加 菜单 项 。 
Menu 类 的 add() 方 法 的 参数 说 明 如 下 : 
int groupId: 分 组 标识 ,其 值 相同 的 菜单 项 可 以 归 为 一 组 。 
int itemId: 菜单 项 ID ,代表 菜 单项 的 唯一 编号 ,使 用 这 个 编号 可 以 找到 对 应 的 菜 
单项 。 
int order: 菜单 项 排列 顺序 (代表 的 是 菜单 项 显示 顺序 ,默认 值 是 0) ,其 值 越 小 越 
表示 越 重要 ,优先 显示 。 
CharSequence title: String 类 型 的 菜单 项 标题 ,表示 需要 在 界面 选项 中 显示 的 文 
字 。 除 了 使 用 字符 串 ,还 可 以 使 用 一 个 字符 串 资 源 , 通 过 R. java 文件 常量 文件 。 
分 组 ID .菜单 项 ID 和 排列 属性 都 是 可 选 的 ,如 果 不 想 特别 指定 的 话 可 以 使 用 Menu 
.NONE。 代 码 4.5 给 出 了 一 个 简单 的 例子 ,演示 了 如 何 使 用 add() 方 法 动态 加 载 三 个 菜 
单项 。 
代码 4.5 使 用 add() 方 法 动态 加 载 菜单 


@ Override 
public boolean cnCreateoptionsMenu (Menu menu) { 
//call the base class to include system menus 
Super.anCreateOptionsMenu (menu) ; 
menu.add (0 //Group 
11 //item id 
10 //order 
,"append") ; //title 
menu.add (0,2,1, "item2") 7 
menu.add (0,3,2, "clear"); 


retum true; 
} 


对 于 菜单 选项 的 单 击 事件 ,Android 系统 使 用 专门 的 方法 来 进行 处 理 。 当 用 户 单 击 
菜单 项 时 ,系统 会 调用 Activity 的 onOptionsItemSelected() 方 法 ,并 且 将 用 户 单 击 的 菜单 
项 对 象 (Menultem) 传 递 给 该 方法 。 在 这 个 方法 中 ,可 以 用 getItemId() 方 法 来 获取 菜单 
项 的 资源 ID ,针对 不 同 的 菜单 项 进行 不 同 的 操作 。 代 码 4. 6 中 ,通过 getItemId() 获 取 菜 
单 ID 后 ,通过 判断 ID 不 同 的 值 ,实现 在 用 户 单 击 菜单 项 后 ,指定 的 文本 框 中 显示 出 所 单 
击 的 菜单 选项 标题 。 当 然 ,这 个 例子 为 了 简单 ,编写 的 事件 响应 操作 代码 都 相同 ,但 实际 
应 用 程序 中 ,对 应 于 每 个 菜单 选项 的 事件 处 理 ,都 对 应 了 其 响应 的 功能 实现 代码 或 方法 。 
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代码 4.6 使 用 onOptionsItemSelected() 方 法 处 理 菜 单项 事件 


如 果 被 选 的 菜单 项 得 到 成 功 处 理 , 则 onOptionsItemSelected() 返 回 true 值 ,否则 , 需 
要 调用 父 类 的 onOptionsItemSelected() 方 法 继续 处 理 。 如 果 Activity 中 包含 Fragment， 
那么 系统 首先 会 调用 Activity 中 onOptionsItemSelected() 方 法 ,然后 才 是 每 个 Fragment 
中 的 方法 onOptionsItemSelected ( ), 直到 有 一 个 方法 返回 true 值 , 否则 所 有 的 
onOptionsItemSelected() 方 法 都 会 被 调用 。 

除了 使 用 onOptionsItemSelected() 之 外 ,还 可 以 使 用 监听 器 来 响应 和 处 理事 件 ,这 
种 方式 需要 实现 OnMenultemClickListner 接口 以 及 其 onMenulItemClick() 方 法 , 见 代码 4.7。 

代码 4.7 定义 OnMenultemClickListner 监听 器 


与 传统 的 Java 事件 处 理 程序 类 似 , Android 应 用 程序 在 使 用 监听 器 处 理事 件 时 ,也 
需要 对 监听 器 进行 注册 。 对 于 代码 4.7 定义 的 监听 器 ,可 以 使 用 下 面 的 代码 注册 : 
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MyResponse myResponser new MyResponse(…)7 
ImenuTtem.setOnMenuTtemClickListener (myResponse); 


如 果 同 时 定义 了 onOptionsItemSelected() 方 法 和 监听 器 处 理 方法 , 单 击 菜单 项 就 会 
首先 执行 监听 器 中 的 onMenuItemClick() 方 法 。 如 果 onMenuItemClick() 方 法 返回 值 为 
true, 则 表示 单 击 菜单 项 的 事件 处 理 已 经 完成 ,就 不 会 执行 onOptionsItemSelected ( ) 方 
法 ;如 果 返 回 值 为 false, 才 执行 onOptionsItemSelected() 方 法 。 另 外 ,在 菜单 资源 文件 中 
Android 系统 还 为 菜单 项 提供 了 android:onClick 属性 ,可 以 定义 菜单 项 处 理 单 击 事件 的 
方法 。 

如 果 多 个 Activity 都 拥有 相同 的 菜单 ,可 以 定义 一 个 只 有 onCreateOptionsMenu() 
和 onOptionsItemSelected() 方 法 的 Activity ,在 其 中 实现 这 个 菜单 ,然后 让 其 他 类 来 继承 
该 类 。 如 果 想 在 子 类 中 添加 新 的 菜单 项 , 则 只 需 重 写 onCreateOptionsMenu() 方 法 ,并 且 
调用 super. onCreateOptionsMenu() 方 法 创建 父 类 的 菜单 项 ,然后 再 使 用 add() 方 法 添加 
新 的 菜单 项 。 

但 是 onCreateOptionsMenu() 方 法 是 用 来 初始 化 菜单 的 状态 ,只 能 在 菜单 刚 被 创建 
时 才 会 执行 ,所 以 不 能 用 这 个 方法 ,只 能 在 Activity 的 生命 周期 中 修改 菜单 。 如 果 要 想 动 
态 改变 选项 菜单 ,就 要 实现 onPrepareOptionsMenu( ) 方 法 ,系统 会 将 当前 使 用 菜单 对 象 
传递 给 该 方法 ,可 以 在 这 个 方法 中 修改 菜单 。Android 2. 3 或 更 低 的 版 本 中 ,系统 会 在 每 
次 菜单 打开 的 时 候 调用 一 次 onPrepareOptionsMenu() 方 法 ;而 在 Android 3.0 及 以 上 版 
本 ,由 于 选项 菜单 是 在 动作 条 中 显示 的 ,此 选项 菜单 总 是 打开 的 ,所 以 必须 调用 
invalidateOptionsMenu() 方 法 请 求 系 统 调用 onPrepareOptionsMenu() 方 法 执行 更 新 
操作 。 

下 面 用 一 个 简单 的 例子 来 说 明 在 应 用 程序 中 如 何 实现 选项 菜单 。 从 初始 状态 到 完成 
菜单 事件 处 理 ,分 为 7 个 步骤 ,下 面 进行 具体 介绍 。 

(1) 新 建 一 个 Activity: 在 Android 项 目 中 新 建 一 个 Activity。 

(2) 创建 资源 文件 夹 : 在 Android 项 目的 /res 目录 下 ,使 用 Eclipse 的 File>New 一 
Folder 创建 一 个 新 文件 夹 ,命名 为 menu, 作 为 菜单 资源 文件 存储 的 目录 。 如 果 这 个 目录 
已 经 存在 ,就 使 用 已 存在 的 目录 。 

(3) 创建 菜单 XML 文件 : 在 menu 目录 下 ,使 用 与 创建 布局 文件 类 似 的 步骤 ,创建 
菜单 XML 文件 ,命名 为 my_options_menu. xml, 根 节点 元 素 为 王 menu 二。 文件 的 内 容 
如 下 : 


< menu xmlns:android= "http://schemas.androidq.coapkyres/android"> 
< /menn> 


(4) 添加 Menu Items: 使 用 二 item 二子 元 素 , 在 my_options_menu. xml 中 添加 所 需 
的 菜单 选项 。 代 码 如 下 : 
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(5) 创建 Menu Items 的 图 标 : 如 果菜 单 选项 需要 设 定 图 标 ,可 以 把 要 使 用 的 图 标 用 
PNG 文件 格式 存放 在 应 用 程序 的 drawable 目录 下 。 默 认 情 况 下 Eclipse 在 drawable 下 
创建 了 low、medium 和 high 三 个 子 文件 夹 ,图标 文件 可 以 放 在 任意 文件 夹 中 。 

图 标的 指定 可 使 用 item 的 icon 属性 .具体 语法 见 下 列 代码 。 


(6) 获取 菜单 资源 : 菜单 资源 文件 定义 完成 后 ,要 显示 在 用 户 界面 上 ,需要 Activity 
加 载 定义 好 的 菜单 ,在 其 onCreateOptionsMenu() 方 法 中 通过 菜单 资源 文件 名 ,将 定义 好 
的 菜单 实例 化 ,获取 并 加 载 这 个 菜单 对 象 。 下 面 的 代码 是 典型 的 菜单 资源 获取 方法 。 


(7) 响应 Item 选择 事件 : 菜单 加 载 后 ,需要 完成 的 就 是 菜单 选项 的 处 理 。 最 简单 的 
方法 就 是 使 用 Activity 提供 的 onOptionsItemSelected() 方 法 。 


到 此 为 止 ,菜单 的 建立 就 完成 了 。 在 菜单 的 具体 实现 过 程 中 ,并 不 是 每 一 个 步骤 都 需 


BD/ 
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要 完成 ,可 以 根据 具体 的 情况 省 略 。 

2. 上 下 文 菜单 

在 桌面 系统 的 用 户 界面 中 , 当 用 户 使 用 鼠标 右 击 界面 视图 元 素 时 ,桌面 系统 就 会 弹出 
与 此 视图 元 素 相关 的 动作 列表 。 这 个 功能 非常 方便 ,用 户 可 以 很 容易 找到 与 视图 元 素 相 
关 的 功能 。 提 供 这 种 功能 的 菜单 ,成 为 上 下 文 菜单 。 

Android 系统 也 支持 相同 的 设计 模式 ,但 由 于 用 户 交 互 的 设备 不 同 ,操作 时 界面 的 响 
应 有 所 不 同 。Android 的 上 下 文 菜单 可 以 通过 触摸 屏 操作 调 出 。 当 用 户 按 住 触摸 屏 上 的 
视图 元 素 保持 一 段 时 间 , 就 可 以 调 出 相关 动作 列表 的 上 下 文 菜单 。Android 系统 可 以 为 
任何 视图 提供 上 下 文 菜单 ,但 是 通常 在 ListView GridView 中 的 项 目 上 使 用 ,或 者 其 他 
视图 集合 中 的 项 目 。 

Android 系统 定义 了 如 下 两 种 模式 的 上 下 文 菜单 。 

(1) 浮动 模式 如 果 用 户 在 视图 元 素 上 执行 一 个 长 单 击 ( 按 住 并 保持 ) 事 件 , 上下文 
菜单 项 浮动 列表 会 弹出 ,类 似 对 话 框 ,显示 在 原 有 视图 的 上 面 , 覆 盖 原 有 的 部 分 用 户 界面 
如 图 4.3 左 图 所 示 。 用 户 可 以 每 次 在 浮动 菜单 中 选择 一 个 可 执行 的 动作 。 


HenyV 
Henry Vil 
Richard ll 
Merchant of Venice 


Othello 


King Lear 


图 4.3 Android 3.0 上 下 文 菜单 界面 


(2) 动作 模式 : 这 种 模式 是 ActionMode 的 系统 实现 ,可 以 在 屏幕 项 部 显示 上 下 文 动 
作 条 ,其 中 的 菜单 项 是 影响 所 选 视图 元 素 的 动作 。 当 这 种 模式 被 激活 ,用 户 可 以 在 使 用 上 
下 文 菜单 的 动作 条 中 选择 一 个 或 多 个 动作 。 但 是 ,这 种 模式 只 有 在 Android 3. 0 或 者 更 
高 版 本 可 用 ,是 使 用 上 下 文 菜 单 的 推荐 模式 。 

上 下 文 菜单 的 加 载 与 选项 菜单 类 似 , 都 是 在 Activity 中 通过 特定 方法 中 创建 和 加 载 ， 
但 具体 在 onCreateContextMenu() 方 法 中 实现 ,而 不 是 在 onCreateOptionsMenu( ) 方 法 
中 实现 。 在 实现 onCreateContextMenu() 方 法 时 ,上 下 文 菜单 所 依赖 的 视图 元 素 通 过 参 
数 指定 。 

上 下 文 菜单 的 加 载 与 选项 菜单 在 加 载 时 有 所 不 同 。onCreateOptionsMenu() 方 法 在 
每 个 Activity( 或 者 Fragment) 启 动 时 自动 调用 。 因 为 不 是 界面 上 的 所 有 视图 元 素 都 需要 
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上 下 文 视图 元 素 , 只 有 通过 registerForContextMenu(view) 方 法 注册 的 视图 元 素 , 才 有 可 
能 创建 对 应 的 上 下 文 菜单 。 因 此 只 有 用 户 长 时 间 单 击 某 个 视图 元 素 后 才 需 要 执行 
onCreateContextMenu() 方 法 。 

下 面 用 一 个 简单 的 例子 来 说 明 在 应 用 程序 中 如 何 实现 上 下 文 菜单 。 具 体 创建 步骤 的 
前 5 步 与 选项 菜单 相同 ,从 第 6 步 开 始 有 所 不 同 。 具 体 描述 如 下 : 

(1) 新 建 一 个 Activity Class。 

(2) 创建 资源 文件 夹 。 

(3) 创建 Menu XML 文件 。 

(4) 添加 Menu Items。 

(5) 创建 Menu Items 的 图 标 。 

(6) 注册 视图 元 素 。 通 过 调用 resisterForContextMenu() 方 法 为 视图 元 素 注册 上 下 
文 菜单 。 如 果 Activity 使 用 了 ListView 或 者 GridView, 且 想 要 其 中 的 每 个 项 目 都 提供 
一 个 相同 的 上 下 文 菜单 ,那么 需要 将 ListView 或 者 GridView 对 象 传递 到 
registerForContextMenu() 方 法 中 。 

(7) 获取 菜单 资源 : 在 Activity( 或 者 Fragment) 实 现 onCreateContextMenu() 方 法 。 
被 注册 视图 元 素 接收 到 一 个 长 单 击 事件 ,那么 系统 将 会 调用 这 个 方法 ,在 这 里 可 以 创建 上 
下 文 菜单 ( 见 代 码 4. 8) 。 

代码 4.8 覆盖 onCreateContextMenu( ) 方 法 


@ Override 
Public void cncreateContextMenu (ContextMenu menu, View vv 
ContextMenuTnfo menuInfo) { 
super .onCreateContextMenu (menu, V, menuInfo); 
MenuInflater inflater= getMenuInflater(); 
inflater.inflate (R.menu.context menu, menu); 
上 


Menulnflater 对 象 允许 使 用 菜单 资源 填充 上 下 文 菜单 对 象 。onCreateContextMenu() 
方法 的 参数 包含 了 用 户 选 择 的 视图 元 素 v 和 提供 关于 被 选项 额外 信息 的 menuInfo 对 
象 。 如 果 需 要 为 Activtiy 中 若干 个 视图 元 素 提供 不 同上 下 文 菜单 ,需要 使 用 这 些 参数 来 
确定 需要 填充 的 上 下 文 菜 单 。 

(8) 响应 Item 选择 事件 : 对 于 上 下 文 菜 单 选项 的 单 击 事件 , Android 系统 使 用 
onContextItemSelected() 方 法 来 进行 处 理 。 当 用 户 单 击 上 下 文 菜单 项 时 ,系统 会 调用 
Activity 的 onContextItemSelected() 方 法 ,并 且 将 用 户 单 击 的 菜单 项 对 象 (MenuItem) 传 
递 给 该 方法 。 

具体 实现 响应 Item 选择 事件 ,. 覆 写 onContextItemSelected () 方 法 时 ,可 以 用 
getItemId() 方 法 来 获取 菜单 项 的 资源 ID, 针 对 不 同 的 菜单 项 ,编写 不 同 的 代码 实现 其 功 
能 ( 见 代码 4.9) 。 
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代码 4.9 使 用 onContextItemSelected() 方 法 处 理 菜单 项 事件 


@ Overrige 
Public boolean cnContext TtemSelected (MenuTtem item) { 
GapterContestMenuInfo info= (adapterCbntextMennInfo) itemgetMenuInfo() 
switch (item.getItemId()) { 
case R.id.edit: 
editNote (info.ig); 
retum true; 
Case R.id.delete: 
GeleteNote (info.iqd); 
Tetum true; 
Gefault: 
ITeturn super.onContextItemSelected (item); 


} 


如 果 被 选 的 菜单 项 得 到 成 功 处 理 , 则 onContextItemSelected() 返 回 true 值 ,否则 , 需 
要 调用 父 类 的 onContextItemSelected() 方 法 继续 处 理 。 与 选项 菜单 类 似 , 如 果 Activity 
中 包含 Fragment, 那 么 Activity 将 首先 执行 自己 的 这 个 方法 ,如 果 返 回 值 为 false, 则 通过 
调用 super. onContextItemSelected (item) 方 法 , 单 击 事件 将 会 在 每 个 Fragment 中 的 
onContextItemSelected() 方 法 中 传递 ,按照 Fragment 被 添加 的 顺序 一 个 接着 一 个 ,直到 


返回 true 或 者 全 部 执行 完 为 止 。 
3. 弹出 菜单 


弹出 菜单 是 在 API 级 别 11 和 更 高 版 本 上 才 有 效 。 弹 出 菜单 是 一 个 在 视图 元 素 上 弹 
出 的 模式 菜单 。 如 果 这 个 视图 元 素 下 方 有 空间 ,那么 弹出 菜单 将 显示 在 视图 元 素 的 下 方 ， 
否则 会 显示 在 上 方 。 弹 出 菜单 与 上 下 文 菜单 不 同 ,. 上 下 文 菜单 


是 对 选择 内 容 有 影响 的 操作 。 Repyal 
弹出 菜单 的 功能 包括 如 下 。 下 


(1) 为 关联 到 特殊 内 容 的 动作 提供 一 个 溢出 模式 的 菜单 。 图 4.4 Gmail 邮件 头 部 


例如 Gmail 的 邮件 头 部 (如 图 4.4 所 示 ) 。 


(2) 提供 一 个 命令 的 第 二 部 分 。 例 如 一 个 标记 为 Add 的 按钮 ,使 用 不 同 Add 选项 可 


产生 一 个 弹出 菜单 。 
(3) 提供 一 个 类 似 Spinner 的 下 拉 菜 单 。 


创建 弹出 式 菜单 的 步骤 与 前 两 种 菜单 类 似 。 具 体 创建 过 程 中 ,前 五 步 与 前 两 种 菜单 


相同 ,从 第 六 步 开 始 有 所 不 同 。 
假设 已 经 定义 了 菜单 资源 文件 popup_color_menu. xml( 见 代码 4. 10) 和 


有 户 界面 布 


局 文件 popmenudemo. xml( 见 代码 4. 11) , 则 显示 出 弹出 菜单 还 需要 以 下 几 步 。 
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代码 4.10 弹出 菜单 资源 文件 定义 


代码 4.11 一 个 按钮 的 布局 文件 


(1) 创建 PopupMenu 对 象 : 在 所 依附 的 视图 元 素 的 Activity 初始 化 时 ,使 用 
PopupMenu 的 构造 方法 实例 化 一 个 弹出 菜单 对 象 ,把 当前 应 用 的 Context 和 所 依附 的 视 
图 元 素 作 为 参数 。 这 里 把 实例 化 后 的 按钮 和 当前 的 Activity 作为 创建 PopupMenu 时 的 
参数 。 


(2) 获取 菜单 资源 ,并 导入 到 popmenu 对 象 。 可 以 调用 PopupMenu. getMenu() 来 
返回 菜单 对 象 。 在 API 14 及 高 于 14 的 ,也 可 以 用 PopupMenu. inflate() 来 导入 。 


。 调用 PopupMenu. show()。 在 按钮 单 击 事件 处 理 的 onClicklistener 中 调用 
PopupMenu. show() 方 法 ,显示 预定 义 的 弹出 菜单 。 
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。 菜单 选项 事件 处 理 : 对 弹出 菜单 选项 的 事件 处 理 时 , 必须 实现 PopupMenu 
. OnMenultemClickListener 接口 ,并 且 通 过 调用 setOnMenultemClickListener() 
方法 把 它 注册 给 的 PopupMenu 对 象 。 当 用 户 选择 某 个 菜单 选项 时 ,系统 会 调用 
此 接口 中 的 onMenuItemClick() 回 调 方法 进行 处 理 。 

在 此 例 中 ,直接 通过 匿名 内 部 类 的 方式 ,实现 了 PopupMenu. OnMenultemClick- 
Listener 接口 ,并 在 其 onMenuItemClick() 方 法 中 根据 用 户 的 选择 改变 背景 的 颜色 。 然 
后 使 其 注册 到 按钮 上 。 具 体 的 代码 实现 和 此 例 完 整 的 程序 见 代 码 4. 12。 

代码 4.12 创建 弹出 菜单 
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菜单 组 是 菜单 项 集合 ,可 以 用 来 为 菜单 项 设置 共同 的 属性 。 菜 单 组 的 设置 可 以 使 一 
组 菜单 选项 的 属性 同时 改变 ,呈现 出 共同 的 特性 。 例 如 : 

。 使 用 setGroupVisible() 显 示 或 隐藏 组 内 所 有 选项 。 

。 使 用 setGroupEnabled() 启 用 或 禁止 组 内 所 有 选项 。 

。 使 用 setGroupCheckable() 说 明 组 内 所 有 的 选项 是 否 可 选 。 

菜单 组 可 以 在 菜单 资源 文件 中 定义 ,把 二 item 二 元 素 腐 套 进 二 group 元 素 中 来 创建 
分 组 菜单 ;或 者 在 Android 应 用 程序 中 ,使 用 带 有 分 组 ID 的 add() 方 法 创建 分 组 。 代 
码 4.13 是 一 个 在 菜单 资源 文件 中 定义 分 组 的 简单 例子 。 

代码 4.13 菜单 分 组 定义 


在 代码 4. 13 中 ,分 组 菜单 中 的 两 个 菜单 项 与 第 一 个 菜单 项 显示 在 同一 个 层次 级 别 
上 ,看 上 去 没有 什么 区 别 。 但 是 ,能 够 使 用 Android API 中 的 方法 ,通过 引用 分 组 ID 同时 
修改 其 中 两 个 菜单 项 的 属性 ,而 且 系 统 不 会 将 分 组 的 菜单 项 给 分 开 。 
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菜单 组 还 可 以 用 来 显示 应 用 程序 中 的 选项 开关 ,设置 
单 选 和 多 选 两 种 方式 ( 见 图 4. 5) 。 

但 是 ,如 果菜 单 组 中 的 菜单 选项 是 图 标 类 型 , 则 不 能 
显示 成 复 选 框 或 单 选 按钮 。 如 果 选 择 了 让 图 标 菜单 中 的 
菜单 项 可 复 选 ,就 必须 在 每 次 状态 改变 时 通过 手动 更 换 图 
标 与 文本 来 指明 复 选 的 状态 。 

菜单 资源 文件 中 ,一 item 二 元 素 中 的 android: 
checkable 属性 用 于 给 单独 的 菜单 项 定义 是 否 可 选 ， 
一 group 二 元 素 中 的 android:checkableBehavior 属性 用 于 
给 一 组 菜单 项 定义 可 选 类 型 ( 见 代码 4. 14)。 本 

代码 4.14 为 菜单 项 设置 单 选 按钮 


< ?ml version= "1 .0" encodingF "utf- 8"?> 
< menu xmlns:android= "http://schemas.android.caw/apk/res/android"> 
< group android:checkableBehavior= "single"> 
< item android:id= "@ + id/red" 
android:title= "@ string/red" /> 
< item android:id= "@ + id/blue" 
android:title= "@ string/blue"/> 
< /grop> 
< /menn> 


二 group 二 元 素 的 android:checkableBehavior 属性 可 以 有 以 下 3 种 设置 : single 代表 
菜单 组 中 仅 有 一 项 能 够 被 选 ( 单 选 按钮 ) ;all 代表 所 有 菜单 项 都 能 够 被 选 ( 复 选 框 ); none 
代表 没有 项 目 是 可 复 选 的 。 在 过 item 过 元 素 中 可 以 使 用 android:checked 属性 给 菜单 项 
设置 默认 的 选择 状态 ,也 可 以 用 setChecked() 方 法 在 代码 中 改变 。 

当 一 个 可 复 选 的 菜单 项 被 选择 的 时 候 , 系 统 会 调用 对 应 被 选择 的 菜单 项 的 回调 方法 
(如 onOptionsItemSelected()) 。 由 于 复 选 框 或 复 选 按钮 不 会 自动 的 改变 它们 的 状态 , 因 
此 必须 在 这 个 方法 中 重新 设置 复 选 框 的 状态 。 一 般 使 用 isChecked() 方 法 来 查询 复 选 菜 
单 的 当前 状态 (被 用 户 选择 之 前 的 状态 ) ,然后 用 setChecked() 方 法 设置 选择 状态 ( 见 代 
码 4.15) 。 


代码 4.15 在 事件 处 理 方法 中 设置 菜单 项 的 选择 状态 


@ override 
public boolean cnOptionsTtemSelected (MenuTtem item) { 
Switch (item.getItemId()) { 
case R.id.vibrate: 
case R.id.dont vibrate: 
证 (item.ischecked!()) item.setChecked (false); 
else item.setChecked (true); 
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如 果 不 用 这 种 方式 设置 复 选 状态 ,那么 当 用 户 选择 菜单 项 ( 复 选 框 或 复 选 按钮 ) 的 时 
候 , 它 的 可 视 状 态 将 不 会 发 生 改变 。 
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菜单 选项 也 可 以 创建 Intent 来 启动 男 一 个 Activity, 这 个 Activity 既 可 以 是 本 应 用 
程序 中 的 ,也 可 以 是 其 他 应 用 程序 中 的 。 如 果 确 认 了 所 需 的 Intent 的 特性 以 及 初始 化 此 
Intent 的 菜单 选项 后 ,就 可 以 在 菜单 选项 事件 响应 的 回调 方法 中 使 用 startActivity() 运 
行 此 Intent。 

但 是 添加 调用 这 个 Intent 对 象 的 菜单 项 之 后 ,如 果 不 能 确定 用 户 设备 上 是 否 包 含 了 
处 理 这 个 Intent 对 象 的 应 用 程序 ,就 有 可 能 由 于 没有 接收 这 个 Intent 对 象 的 Activity, 导 
致 这 个 菜单 选项 不 会 有 任何 作用 ,不 能 实现 预期 的 功能 ,成 为 一 个 非 功能 性 菜单 选项 。 这 
个 问题 可 以 使 用 动态 添加 菜单 项 的 方法 来 解决 ,Android 通过 在 设备 上 查找 处 理 Intent 
对 象 的 Activity, 动 态 地 把 菜单 项 添加 到 菜单 中 。 

为 了 防止 上 述 问 题 的 发 生 , 可 以 在 添加 菜单 选项 具体 采取 一 些 措 施 , 例 如 : 

(1) 使 用 分 类 CATEGORY _ ALTERNATIVE 和 CATEGORY _ SELECTED _ 
ALTERNATIVE 定义 的 Intent。 

(2) 调用 Menu. addIntentOptions() 方 法 ,Android 系统 会 搜索 能 够 接收 这 个 Intent 
对 象 的 应 用 程序 ,将 菜单 选项 添加 到 菜单 中 。 

(3) 如 果 没 有 应 用 程序 满足 Intent 的 要 求 ,就 不 添加 菜单 选项 。 

由 于 CATEGORY_SELECTED_ALTERNATIVE 只 用 于 处 理 当 前 屏幕 上 被 选择 的 
元 素 , 因 此 只 在 用 onCreateContextMenu() 方 法 创建 菜单 时 使 用 这 个 分 类 ( 见 代码 4. 16) 。 

代码 4. 16 动态 添加 Intent 菜单 选项 


@ Override 
Public boolean cnCreateOptionsMenu (Menu menu) { 
super .onCreateOptionsMenu (menu) ; 


//Create an Intent that describes the reqpirements to fulfill, to be included 
//in ur menu. The offering app mst include a category value of Intent. 
//CATEGORY ALTEFNATIVE 

Intent intent— new Intent (null, dataUri); 

intent .adicategory (Intent. .CATROORY ALTERNATIVE); 


//Search and populate the menu with acoeptable offering applications 
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menu.addIntentOptions( 
R.id.intent group, //Menu group to which new items will be added 
0, /Uniqne item ID (none) 
0, //Order for the items (none) 
this.getCmponentName(),  //The current Activity name 
null, //Specific items to Place first (none) 
intent, //Intent created above that describes our requirements 
0, //Beditional flags to control items (none) 
null) //Array of MEnuTtems that correlate to specific items (none) 


retum true; 
} 


每 找到 一 个 Intent filter 与 所 定义 的 Intent 对 象 相 匹 配 的 Activity, Menu 类 的 
addIntentOptions( ) 方 法 都 会 添加 一 个 菜单 项 ,这 个 菜单 项 使 用 其 Intent filter 的 
android:label 的 属性 值 作为 菜单 项 的 标题 ,应 用 程序 的 图 标 作为 菜单 项 的 图 标 。 
addIntentOptions() 方 法 返回 被 添加 的 菜单 的 个 数 。 


4.2 动作 条 模式 


动作 条 (ActionBar) 是 位 于 Activity 顶端 的 一 个 图 形 控件 ,能 够 显示 Activity 的 标 
题 . 图 标 、 可 能 触发 的 动作 、 附 加 视图 和 其 他 交互 控件 ,也 可 以 用 于 在 应 用 程序 中 导航 。 

动作 条 是 用 户 浏览 界面 非常 重要 的 设计 元 素 , 动 作 条 主要 提供 以 下 功能 。 

。 支持 应 用 程序 内 的 一 致 导航 和 视图 切换 。 

。 为 极 少 使 用 的 操作 提供 “溢出 动作 ”模式 ,减少 混乱 。 

。 提供 专门 位 置 来 显示 应 用 程序 的 标识 ,提示 用 户 在 当前 应 用 程序 中 的 位 置 。 

。 突出 重要 操作 ,提供 预 访问 模式 。 

对 于 大 多 数 应 用 ,动作 条 可 以 分 割 为 应 用 图 标 、 视 图 控制 .动作 按钮 和 溢出 动作 4 个 
不 同 的 功能 区 域 ,分 别 对 应 于 图 4.6 中 标识 的 1.2.3 和 4 个 区 域 。 
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图 4.6 ActionBar 的 4 个 区 域 
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1. 应 用 图 标 

应 用 图 标 是 应 用 程序 的 标识 ,需要 时 可 以 使 用 不 同 的 Logo 或 标牌 。 如 果 当 前 不 是 
应 用 的 顶层 界面 , 则 在 图 标 左边 会 有 一 个 向 左 的 箭头 ,表示 “向 上 ”按钮 ,使 用 户 可 以 回 到 
上 一 级 界面 (图 4.7 中 右 图 的 Logo 左边 )。 

2. 视图 控制 号 App home 《Wt Lowerlevel 

如 果 应 用 程序 可 以 在 多 个 不 同 的 视图 中 显示 数 图 4.7 应 用 图 标 
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据 , 动 作 条 的 “视图 控制 ?能 让 用 户 在 视图 之 间 进 行 切换 。 例 如 ,可 以 在 下 拉 菜 单 和 标签 视 
图 之 间 进 行 切换 。 如 果 应 用 程序 不 支持 不 同 的 视图 ,也 可 以 使 用 这 个 区 域 显 示 非 交互 内 
容 , 例 如 应 用 程序 标题 或 较 长 的 标识 信息 。 

3. 动作 按钮 

用 于 显示 应 用 程序 中 最 重要 的 动作 。Android 提供 动作 条 的 设计 模式 是 为 了 方便 用 
户 选 择 与 上 下 文 环境 相关 的 最 重要 的 动作 ,那些 直接 显示 在 动作 按钮 区 域 上 的 图 标 或 者 
文本 被 称 为 动作 按钮 。 如 果 动 作 条 的 这 部 分 区 域 不 够 容纳 所 有 的 动作 ,就 自动 移入 后 面 
的 “溢出 动作 ”。 长 单 击 图 标 就 可 以 显示 出 “溢出 动作 ”中 隐藏 的 动作 。 

4. 溢出 动作 

平常 很 少 用 到 的 动作 一 般 被 放 在 这 部 分 区 域 中 。 动 作 按钮 区 域 和 洪 出 动作 区 域 中 的 
动作 按钮 可 能 会 根据 屏幕 的 大 小 和 形状 发 生变 化 。 

Android 2. 3 以 及 之 前 的 系统 使 用 设备 上 的 返回 键 实现 一 个 应 用 程序 内 部 的 浏览 ， 
这 就 是 返回 浏览 模式 。 但 是 从 Android 3.0 版 本 开始 ,Android 设备 使 用 虚拟 浏览 条 ， 
即 动作 条 ,代替 了 传统 的 物理 按键 。 当 Activity 使 用 系统 的 默认 主题 模式 显示 时 ,动作 
条 就 出 现在 Activity 窗口 的 项 部。 当然 也 可 以 通过 属性 设 定 动作 条 的 模式 和 增加 动 
作 条 。 

动作 条 的 APIs 首先 在 Android 3. 0(API level 11) 系 统 使 用 ,但 是 要 在 Android 2. 1 
(API level 7) 的 版 本 中 运行 时 ,也 可 以 导入 相应 的 库 兼 容 支 持 。 在 不 同 的 Android 版 本 
中 ,大 多 数 API 都 是 相同 的 ,只 是 所 在 的 包 不 同 。 

如 果 支 持 API level 11 低 的 版 本 : 


import android. support .v7.app.ActionBar 
如 果 支 持 API level 11 高 的 版 本 : 


默认 状态 下 ,动作 条 跟 在 应 用 程序 标题 后 面 ,显示 在 应 用 程序 的 顶部 。 如 果 Activity 
设置 了 弹出 菜单 ,就 可 以 直接 从 动作 条 以 动作 选项 的 方式 直接 访问 。 

使 用 动作 条 可 以 与 许多 控件 结合 使 用 ,动作 条 支持 的 基本 应 用 模式 如 下 。 

。 动作 选项 (Action Items)。 

。 动作 视图 (Action Views) 。 

。 动作 提供 器 (Action Provider) 。 

。 导航 标签 (Navigation Tabs) 。 

。 下拉 菜单 (Dropdown Menu)。 
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从 Android 3.0(API Level 11) 开 始 , 动 作 条 就 被 包含 在 使 用 Theme. Hole 主题 的 
Activity 中 ,或 者 是 这 些 Activity 的 子 类 中 。 由 于 动作 条 只 能 运行 在 Android 3. 0(API 
Level 11) 或 更 高 的 版 本 上 ,动作 条 蔡 代 了 选项 菜单 ,并 且 蔡 换 了 传统 的 应 用 程序 标题 栏 。 
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在 添加 动作 选项 到 动作 条 之 前 ,因此 需要 打开 Manifest 文件 ,确认 用 户 SDK 的 属性 
targetSdkVersion 或 minSdkVersion 属性 被 设置 为 11 或 更 大 的 数值 。 下 面 的 代码 是 一 
个 设置 targetSdkVersion 属性 的 例子 。 


<manifest …> 


在 这 个 例子 中 ,应 用 程序 运行 要 求 的 最 小 API 版 本 是 4(Android 1. 6) ,但 是 目标 
API 版 本 是 11(Android 3. 0) 。 也 就 是 说 在 Android 1. 6 版 本 支持 下 ,应 用 程序 可 以 完成 
基础 重要 的 功能 ,但 当 应 用 程序 运行 在 Android 3. 0 或 更 高 的 版 本 上 时 ,系统 就 会 给 每 个 
Activity 应 用 全 景 主题 ,支持 所 有 设计 的 界面 和 功能 ,包括 动作 条 。 如 果 要 使 用 动作 条 
API 来 进行 添加 导航 模式 和 修改 动作 条 样式 的 操作 ,就 要 把 minSdkVersion 属性 设置 为 
11 或 更 大 的 值 。 

在 查看 API 版 本 的 同时 ,还 需要 确认 下 面 列 出 的 代码 不 存在 ,否则 应 用 程序 运行 时 
动作 条 也 不 会 显示 。 


< arpplication 
android:theme= "@ android:style/Theme.NoTitleBar" 


若 在 应 用 程序 界面 中 不 需要 动作 条 ,可 以 把 Activity 的 主题 设置 为 Theme. Holo 
.NoActionBar。 有 具体 代码 如 下 : 


<activity android:theme= "@ androiqd:style/Theme.Holo.NcRctionBar"> 


动作 条 的 显示 和 隐藏 也 可 以 在 应 用 程序 运行 中 进行 动态 调整 。 在 Activity 中 使 用 
getActionBar() 获 取 动 作 条 对 象 后 ,使 用 ActionBar 提供 的 hide() 方 法 和 show() 方 法 可 
以 直接 改变 动作 条 的 显示 状态 ,代码 如 下 。 


ActionBar actionBar= getActionBar (); 
actionBar.hige(); 


当 动作 条 隐藏 时 ,系统 会 调整 Activity 的 显示 大 小 ,来 填充 当前 有 效 的 屏幕 空间 。 在 
隐藏 和 删除 动作 条 时 ,为 了 填充 被 动作 条 占用 的 空间 ,可 能 会 导致 的 Activity 的 重新 布 
局 。 如 果 Activity 有 规律 地 隐藏 和 显示 动作 条 ,使 用 覆盖 模式 是 较 好 的 选择 。 设 置 动 作 
条 覆盖 模式 ,需要 给 Activity 创建 一 个 主题 ,并 且 把 android: windowActionBarOverlay 
属性 设置 为 true。 

默认 情况 下 ,系统 在 动作 条 中 使 用 应 用 的 图 标 , 这 是 通过 一 application 之 和 一 activity 二 
元 素 中 的 icon 属性 指定 。 但 是 ,如 果 设置 了 logo 属性 ,动作 条 会 使 用 logo 属性 指定 的 图 
片 资源 ,而 代 蔡 icon 属性 指定 的 资源 。 
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由 于 Android 3.0 及 以 上 版 本 用 动作 条 替代 了 选项 菜单 , 当 Activity 首次 启动 时 , 系 
统 会 调用 onCreateOptionsMenu() 方 法 创建 动作 选项 类 型 的 动作 条 ,可 以 在 这 个 方法 中 
获取 定义 好 的 XML 菜单 资源 。 而 且 当 动作 选项 的 某 个 选项 被 选中 时 ,对 用 户 操 作 事 件 
的 获取 和 人 处理,Android 系统 同样 调用 onOptionsItemSelected() 方 法 来 进行 处 理 。 因 此 
动作 条 中 动作 选项 的 定义 与 菜单 选项 相同 ,创建 动作 选项 类 型 动作 条 和 事件 处 理 的 过 程 
也 基本 与 选项 菜单 的 步骤 一 致 。 

下 面 用 一 个 简单 的 例子 来 说 明 在 应 用 程序 中 如 何 实现 动 作 选项 的 动作 条 。 假 设 
Activity 的 布局 文件 main_activity_actions. xml 已 经 存在 。 

(1) 确认 manifest 文件 中 的 设置 。 

(2) 打开 或 创建 一 个 Activity 类 。 

(3) 若菜 单 资 源 目录 /res/menu 不 存在 ,创建 这 个 目录 。 

(4) 创建 Menu XML 文件 。 

在 /res/menu 目录 下 创建 菜单 资源 文件 menu_actions. xml, 在 其 中 设置 三 个 菜单 
选项 


代码 4.17 动作 条 中 动作 选项 的 定义 


< menu smlns:android= "http://schemas.android.cam/apk/res/android"> 
< item android:id= "@ + id/action search" 
android:icon= "@ drawable/ic action search" 
android:title= "@ string/action search"/> 
< item android:id= "@ + id/action composen 
android:icon= "@ drawable/ic action save" 
android:title= "@ string/action save"/> 
< item android:id= "@ + id/itemHelp" 
android:icon= "@ drawable/ic action help" 
android:title= "@ string/btnHelp"/> 
< ren> 


1. 设置 显示 动作 选项 

在 XML 文件 中 ,能 够 通过 设置 一 item 之 元 素 的 android: showAsAction 一 "ifRoom'" 
属性 ,使 菜单 项 显示 在 动作 条 中 。 菜 单项 首先 作为 动作 按钮 显示 在 动作 条 中 ,如 果 没有 足 
够 的 空间 ,其 他 菜单 项 会 显示 在 溢出 动作 中 。 

< 一 item 二 元 素 的 android:showAsAction 有 一 系列 属性 ,下 面 列 出 重要 的 几 个 。 

。 never: 此 菜单 项 不 显示 在 动作 条 中 , 当 单 击 菜单 按钮 时 .显示 在 列表 中 。 

。 ifRoom: 如 果 动 作 条 有 足够 空间 ,此 菜单 项 显示 在 动作 条 上 。 

。 always: 此 菜单 项 一 直 作 为 动作 按钮 显示 ,但 不 推荐 使 用 ,可 能 会 引起 视图 重 和 。 

。 withText: 此 菜单 项 使 用 定义 的 文本 模式 显示 。 

如 果菜 单项 使 用 android:title 和 android:icon 属性 同时 设置 了 标题 和 图 标 ,那么 默 
认 情 况 下 ,动作 条 中 动作 项 仅 显 示 图 标 。 如 果 要 显示 文本 标题 ,就 要 给 android: 
showAsAction 属性 添加 withText 设置 ,表示 需要 显示 标题 ,代码 如 下 : 
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android:showAsAction= "ifRoom|withText"/> 


一 般 来 说 ,即使 不 需要 在 动作 条 上 显示 文本 标题 ,也 应 该 在 XML 文件 中 给 每 个 菜单 
项 定义 android:title 属性 ,这 是 因为 需要 考虑 下 面 几 种 情况 : 

。 如 果 动 作 条 中 没有 足够 的 空间 来 显示 动作 项 ,菜单 项 就 会 显示 在 溢出 动作 中 ,在 
这 里 只 能 显示 标题 。 

。 车 只 用 图 标 来 显示 动作 项 , 当 用 户 长 单 击 动作 按钮 时 ,可 以 显示 带 有 标题 的 提示 
信息 。 

。 屏幕 阅读 器 可 以 给 有 视觉 障碍 的 用 户 朗 读 菜单 项 标题 。 

添加 动作 选项 显示 设置 代码 后 的 菜单 资源 资源 文件 见 代 码 4. 18。 

代码 4.18 设置 显示 动作 选项 


<menu xmlns:android= "http://schemas.android.cam/apk/res/android"> 
< item android:id= "e+ id/action search" 
android:ioon= "@ drawable/ic action search" 
android:showAsAction= "ifRoam|withText"/> 
android:title= "@ string/action search"/> 
< item android:id- "@ + id/action ccmposen 
android:ioon= "@ drawable/ic action save" 
android:showAsAction= "ifRoam| withText"/> 
android:title= "@ string/action save"/> 
< item android:id= "@ + id/itenHelp" 
android:ioon= "@ drawable/ic action help" 
android:showAsAction= "ifRoam| withText"/> 
android:title= "@ string/binHelp"/> 
< /menn> 


2. 获取 Menu XML 定义 的 动作 选项 资源 

在 Activity 中 ,动作 选项 资源 的 获取 方式 与 选项 菜单 相同 ,都 可 以 从 预定 义 好 的 菜单 
资源 文件 中 加 载 ,在 onCreateOptionsMenu() 方 法 中 实现 创建 动作 选项 。 这 里 ,使 用 
Menulnflater 类 的 inflate() 方 法 ,从 menu_actions. xml( 见 代码 4. 18 ) 文 件 中 获取 预定 义 
的 菜单 项 资源 ,作为 动作 选项 ( 见 代 码 4. 19) 。 

代码 4.19 获取 菜单 资源 


@ Override 

public boolean cncreateoptionsMenu (Menu menu) { 
//Inflate the menu items for use in the action bar 
MenuInflater inflater= getMenuInflater (); 
inflater.inflate (R.menu.menu actions, menu); 
retum super.onCreateOptionsMenu (menu); 
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3. 响应 动作 选项 的 选择 事件 

动作 选项 加 载 后 ,需要 完成 的 就 是 动作 选项 的 事件 处 理 了 。 与 选项 菜单 相同 ,最 简单 
的 方法 就 是 使 用 Activity 提供 的 onOptionsItemSelected() 方 法 。 当 用 户 选 择 了 一 个 动作 
时 ,系统 会 调用 Activity 的 onOptionsItemSelected() 方 法 ,并 且 传 递 Menultem 对 象 给 这 
个 方法 。 可 以 使 用 getItemId() 方 法 得 到 android:id 属性 为 菜单 项 定义 的 ID, 用 来 识别 
用 户 单 击 的 动作 。 

代码 4.20 动作 选项 的 事件 处 理 


@ Override 
public boolean cnopticnsTtemselected (MenuTtem item) { 
//Handle presses on the action bar items 
Switch (item.getItemId()) { 
Case R.id.action search: 
Toast .makeText (MainActivity.this, "Seardh is Selected", 
Toast.IENGTH SHORT) .show(); 
retum true; 
Case R.id.action save: 
Toast .makeText (MainActivity.this, "Save is Selected", 
Toast.IENGTH SHORT) .show ()7 
retum true; 
case R.id.action help: 
Toast .makeText MainActivity.this, "Help is Selected", 
Toast.IENGTH SHORT) .show(); 
retum true; 
Gefault: 
Teturn super.onOptionsItemSelected (item); 


了 


如 果 在 Fragment 中 添加 菜单 项 ,那么 通过 Fragment 类 的 onCreateOptionsMenu 回 
调 方 法 , 当 用 户 选 择 其 中 一 个 Fragment 的 菜单 项 时 ,系统 会 调用 那个 Fragment 对 象 对 
应 的 onOptionsItemSelected() 方 法 。 
422 添加 动作 视图 

动作 视图 (Action View) 是 作为 动作 按钮 的 替代 品 显示 在 动作 条 中 的 一 个 可 视 构件 。 
动作 视图 在 不 改变 Activity 或 Fragment 的 情况 下 ,可 以 给 用 户 提供 快捷 的 访问 和 丰富 的 
操作 。 例 如 ,如 果 有 一 个 用 于 搜索 的 可 选 菜单 项 全 ,可 以 用 SearchView 类 来 蔡 代 动作 条 
上 的 搜索 按钮 全 。 图 4.8 显示 了 从 动作 按钮 立 ( 上 图 ) 展 开 为 动作 视图 (下 图 ) 的 例子 。 

在 菜单 资源 文件 中 ,可 以 使 用 二 item 二 的 android: actionLayout 或 android 
actionViewClass 属性 来 指定 一 个 布局 资源 或 控件 类 ,从 而 定义 一 个 动作 视图 。 例 如 , 代 
码 4. 21 中 指定 了 一 个 SearchView 控件 作为 动作 视图 。 


\® 
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图 Dictionary (el 
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图 Q Search the dictionary 日 
图 4.8 从 动作 按钮 展开 为 动作 视图 
代码 4.21 在 菜单 资源 中 指定 动作 视图 


< Zuml versior= "1.0" encoding= "utf- 8"2> 
< menu xmlns:android= "http://scheras.android.cam/apk/res/android"> 
< item android:id= "@ + id/menu search" 
android:title= "@ string/menu search" 
android:ioon= "@ drawable/ic menu search" 
android:showAsAction= "ifRoam| collapseActionView" 
android:acticnViewClass= "android.widget.SearchView"/> 
< /menu> 


android:showAsAction 属性 也 可 包含 collapseActionView 属性 值 ,这 个 值 是 可 选 
的 。 如 果 android:showAsAction 属性 得 值 包含 了 collapseActionView, 说 明 所 声明 的 动 
作 视 图 会 折 秋 到 一 个 按钮 中 , 当 用 户 选择 这 个 按钮 时 再 展开 。 否 则 ,默认 状态 下 这 个 动作 
视图 是 可 见 的 ,要 占据 动作 条 的 有 效 空间 。 

如 果 为 某 个 动作 选项 设 定 了 动作 视图 ,由 于 在 用 户 选 择 这 个 动作 选项 时 ,系统 会 展开 
对 应 的 动作 视图 ,因此 不 必 在 onOptionsItemSelected() 回调 方法 中 响应 这 个 动作 选项 ， 
进行 相应 的 事件 处 理 ,而 是 直接 交 给 动作 视图 的 事件 处 理 代码 来 完成 。 但 是 , 如果 
onOptionsItemSelected() 中 设置 返回 true 值 ,系统 还 是 会 回调 这 个 方法 ,动作 视图 则 不 
会 打开 。 当 用 户 选择 了 动作 条 中 的 “向 上 ?图标 或 按 下 了 回 退 按钮 时 ,系统 也 会 把 动作 视 
图 折 释 起来。 如 果 需 要 ,可 以 在 代码 中 通过 expandActionView() 和 collapseActionView() 
方法 来 展开 或 折 释 动作 视图 。 

动作 视图 的 事件 处 理 代 码 放 在 Activity 的 onCreateOptionsMenu( ) 方 法 内 , 当 事 件 
发 生 时 系统 回调 此 方法 ,由 注册 的 监听 器 捕获 相应 的 事件 ,执行 事件 处 理 代码 ,实现 选择 
动作 视图 后 对 应 的 功能 。 在 onCreateOptionsMenu() 方 法 中 ,通过 调用 带 有 菜单 选项 ID 
的 findItem() 方 法 来 获取 菜单 选项 ,然后 再 调用 getActionView() 方 法 获得 动作 视图 中 的 
元 素 ( 见 代码 4. 22) 。 

代码 4.22 ”获得 动作 视图 中 的 元 素 


@ Override 
Public boolean onCreateOptionsMenu Menu menu) { 
getMenuInflater () .inflate (R.menu.main activity actions, menu); 
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在 对 动作 视图 操作 时 ,会 有 两 种 情况 : 展开 和 折 倒 。 针 对 这 两 种 操作 , Android 提供 
了 OnActionExpandListener( ) 接口 的 onMenultemActionExpand 方法 和 onMenultem- 
ActionCollapse 方 法 ,在 事件 发 生 时 进行 回调 。 编 写 事件 处 理 代码 时 ,可 以 首先 实现 
OnActionExpandListener 接口 ,根据 不 同 的 操作 ,分 别 在 对 应 的 方法 中 实现 相应 的 功能 。 
然后 创建 一 个 OnActionExpandListener 对 象 , 即 一 个 事件 ,并 使 用 setOnActionExpand- 
Listener() 方 法 来 注册 这 个 事件 。 完 成 这 些 工作 ,系统 就 能 够 在 动作 视图 展开 和 折 盖 时 
使 用 相应 的 回调 方法 进行 处 理 ( 见 代码 4. 23) 。 

代码 4.23 动作 视图 的 事件 处 理 
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与 动作 视图 类 似 , 动 作 提供 器 (Action Provider) 使 用 一 个 定制 的 布局 代替 一 个 动作 
按钮 。 与 动作 视图 不 同 , 当 单 击 动作 提供 器 时 ,其 可 以 显示 子 菜单 ,并 需 对 所 有 选项 进行 
控制 处 理 。 

有 如 下 两 种 方式 来 使 用 动作 提供 器 : 

(1) 在 应 用 程序 代码 中 ,调用 Menultem 类 提供 的 方法 setActionProvider 
(ActionProvider) ,直接 在 菜单 选项 上 设置 动作 提供 器 。 

(2) 在 菜单 资源 文件 中 声明 动作 提供 器 。 

Android 系统 提供 了 一 些 预 定义 的 动作 提供 器 ,例如 ,ShareActionProvider 提供 了 一 
个 子 菜单 ,菜单 中 包括 Google 十 .Hangouts 和 Messaging 等 菜单 选项 ,已 经 实现 了 其 功 
能 。 通 过 使 用 这 个 预定 义 的 动作 提供 器 ,可 以 将 这 些 可 能 共享 的 应 用 列表 直接 在 动作 条 
上 显示 出 来 ,供用 户 使 用 。 使 用 如 果 要 声明 一 个 动作 提供 器 , 需 在 菜单 资源 文件 中 , 设 定 
所 对 应 的 二 item 记 元 素 的 android:actionProviderClass 属性 ,使 用 所 选 的 预定 义 动 作 提供 
器 的 完整 类 名 来 指定 动作 提供 器 ( 见 代 码 4. 24) 。 如 果 需 要 创建 自己 定义 的 动作 提供 器 ， 
也 可 以 通过 继承 ActionProvider 类 来 定义 。 

代码 4.24 声明 动作 提供 器 


< ?ml versior= "] .0" encodingF "utf- 8"?> 
< menu xmlns:android= "http://sachemas.android.com/apk/res/android"> 
< item android:id= "@ + id/menu share" 
android:title= "@ string/share" 
android: showAsAction= "ifRoam" 
ne 


< hren> 


由 于 每 一 个 ActionProvider 类 都 可 以 定义 自身 的 动作 行为 , 就 不 必 在 
onOptionsItemSelected() 监 听 动 作 事 件 。 如 果 需 要 在 onOptionsItemSelected() 方 法 中 对 
其 他 动作 的 事件 进行 处 理 , 必 须 确认 此 方法 的 返回 值 为 false, 从 而 保证 动作 提供 器 上 菜 
单 选项 的 事件 发 生 时 ,系统 能 够 回调 onPerformDefaultAction() 方 法 ,执行 其 事件 处 理 
代码 。 

在 前 面 的 知识 中 提 到 过 ,在 用 户 界面 上 选择 选项 菜单 的 任何 一 个 选项 ,系统 都 会 回调 
onOptionsItemSelected() 方 法 ,而 动作 条 是 Android 高 级 版 本 中 选项 菜单 的 蔡 代 控件 ,所 
以 一 般 情 况 下 ,可 以 把 动作 提供 器 的 事件 处 理 也 放 在 onOptionsItemSelected() 方 法 中 ， 
系统 会 在 选择 动作 提供 器 时 ,回调 这 个 方法 。 

但 值得 注意 的 是 ,如 果 动 作 提供 器 定义 了 一 个 子 菜单 , 则 在 用 户 打开 子 菜单 列表 或 选 
择 子 菜单 选项 时 ,Activity 无 法 接收 onOptionsItemSelected() 的 回调 ,事件 处 理 代码 必须 
写 在 onPerformDefaultAction() 方 法 中 。 


1. 使 用 系统 定义 的 动作 提供 器 

Android 系统 定义 了 一 些 动作 提供 器 ,提供 了 丰富 的 功能 。 每 个 ActionProvider 类 
都 定义 了 自己 布局 (例如 子 菜单 ) 和 动作 行为 ,其 他 的 应 用 程序 在 使 用 这 些 
ActionProvider 时 ,可 以 直接 使 用 其 功能 ,由 onPerformDefaultAction() 回 调 方法 中 系统 
定义 的 代码 来 处 理事 件 ,不 需要 再 在 onOptionsItemSelected() 方 法 中 监听 动作 和 进行 事 
件 处 理 。 但 是 ,尽管 预定 义 的 ActionProvider 提供 了 其 在 溢出 菜单 中 所 能 执行 的 默认 操 
作 , 应 用 程序 的 Activity (或 Fragment) 也 能 


够 通过 处 理 来 自 onOptionsItemSelected() 回 园 < 请 有 | 
调 方法 的 单 击 事件 ,来 重 写 这 个 默认 操作 。 ee 国 coooer 


下 面 把 系统 预定 义 ActionProvider 之 一 @@ Hangouts 
的 ShareActionProvider 类 作为 例子 ,说 明 如 
何 使 用 这 些 ActionProvider。 

ShareActionProvider 类 提供 “共享 ” 动 
作 , 它 负责 创建 子 菜单 的 所 有 逻辑 ,包括 共享 
视图 的 封装 、 单 击 事件 的 处 理 以 及 溢出 菜单 
中 的 选项 显示 等 ,在 使 用 这 个 类 时 ,所 需要 编 
写 的 唯一 的 代码 就 是 给 对 应 的 菜单 项 声明 动 
作 提 供 器 ,并 指定 共享 的 Intent 对 象 。 如 果 
要 在 动作 条 中 提供 一 个 “共享 "动作 ,来 充分 
利用 安装 在 设备 上 的 其 他 应 用 程序 ,例如 把 

- 张 图 片 共 享 给 消息 或 社交 应 用 程序 使 用 ， 
则 使 用 ShareActionProvider 类 是 一 个 有 效 的 
方法 ,如 图 4. 9 使 用 ShareActionProvider 构 
建 的 菜单 所 示 。 

要 使 用 ShareActionProvider 实现 共享 动作 ,需要 再 完成 下 面 几 个 工作 。 

(1) 打开 或 创建 Activity 类 。 

(2) 定义 菜单 资源 文件 。 定 义 动 作 条 上 的 动作 选项 ,并 在 一 item 二 元 素 下 ,定义 
actionProviderClass 属性 的 值 为 ShareActionProvider 的 完整 类 名 ( 见 代码 4. 24) 。 

(3) 获取 ActionProvider 对 象 。 在 Activity 中 定义 一 个 ShareActionProvider 类 型 
的 私有 变量 mShareActionProvider, 然后 在 onCreateOptionsMenu ( ) 方法 中 ,使 用 
getActionProvider() 方 法 获取 跟 menu_share 菜单 项 匹配 的 ShareActionProvider 对 象 ， 
调用 setShareIntent() 方 法 的 事情 是 定义 要 用 于 共享 的 Intent 对 象 。 

代码 4. 25 中 定义 了 getDefaultIntent() 方 法 初始 化 动作 提供 器 ,但 是 当 在 Intent 中 
实际 使 用 的 内 容 设 定 或 改变 时 ,必须 调用 mShareActionProvider. setShareIntent() 更 新 


共享 Intent。 


图 4.9 使 用 ShareActionProvider 构建 的 菜单 


PP 
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代码 4.25 使 用 ShareActionProvider 


代码 4. 25 中 ShareActionProvider 对 象 处 理 所 有 的 跟 这 个 菜单 项 有 关 的 用 户 交互 ， 
并 且 不 需要 处 理 来 自 onOptionsItemSelected() 回调 方法 的 单 击 事件 。 如 果 需 要 重新 定 
义 菜单 项 的 功能 ,可 以 重 写 onOptionsItemSelected() 中 对 应 的 处 理 代码 。 代 码 4. 26 中 在 
onOptionsItemSelected() 回 调 方法 中 重 写 了 menu_share 菜单 项 的 单 击 事件 处 理 代码 , 因 
此 当 用 户 单 击 这 个 菜单 项 时 ,系统 不 再 执行 原 有 的 菜单 功能 ,而 是 实现 重 写 后 的 代码 。 
代码 4. 26 使 用 ShareActionProvider 
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和 


Public void doshare() { 
//populate the share intent with data 
Intent intent= new Intent (Intent.RCTTON SEND); 
intent.setType ("text/plain") ; 
intent .putExtra (Intent. .EXIRA TEXT, "This is a message for you"); 
provider.setShareIntent (intent) ; 
和 


默认 情况 ,ShareActionProvider 对 象 会 基于 用 户 的 使 用 频率 来 保留 共享 目标 的 排列 
顺序 。 使 用 频率 高 的 目标 应 用 程序 会 显示 在 下 拉 列 表 的 上 面 ,并 且 最 常用 的 目标 会 作为 
默认 共享 目标 直接 显示 在 动作 条 。 默 认 情 况 下 ,排序 信息 被 保存 在 由 DEFAULT_ 
SHARE_HISTORY_FILE_NAME 指定 名 称 的 私有 文件 中 。 如 果 只 使 用 一 种 操作 类 型 
ShareActionProvider 类 或 它 的 一 个 子 类 ,可 以 继续 使 用 这 个 默认 的 历史 文件 ;但 是 ,如 果 
使 用 了 不 同类 型 的 多 个 操作 的 ShareActionProvider 类 或 它 的 子 类 , 则 需要 调用 
setShareHistoryFileName( ) 方 法 ,为 每 种 ShareActionProvider 类 都 指定 自己 独立 的 
XML 历史 文件 。 

2. 自 定义 动作 提供 器 

要 创建 自己 的 动作 提供 器 ,只 需 继 承 类 ,并 且 实 现 合适 的 回调 方法 。 下 面 是 需要 实现 
的 几 个 重要 回调 方法 : 

(1) ActionProvider() : 构造 方法 负责 传递 应 用 程序 的 Context 对 象 , 这 个 对 象 需要 
保存 在 一 个 成 员 变 量 中 ,以 便 其 他 的 回调 方法 使 用 。 

(2) OnCreateActionView(): 在 这 个 方法 中 ,可 以 给 菜单 项 定义 动作 视图 。 使 用 从 
构造 方法 中 接收 的 Context 对 象 ,实例 化 一 个 LayoutInflater 对 象 的 ,并 且 用 XML 资源 
来 填充 动作 视图 ,然后 注册 事件 监听 器 。 

代码 4.27 创建 自己 的 ActionProvider 动作 视图 


Public View onCreateActionView () { 
//Inflate the acticn view to be shown cn the action bar 
IayoutInflater layoutInflater= LayoutInflater.fram(rContext); 
View view= layout Inflater.inflate (R.layout.action provider, null); 
ImageButton button= (ImagsButton) view.findViewById (R.id.button); 
button.setOncClickListener (new View.OnClickListener() { 
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(3) onPerformDefaultAction() : 系统 会 在 选中 溢出 菜单 中 的 菜单 选项 时 ,调用 这 个 
方法 ,并 且 动 作 提 供 器 执行 这 个 选中 菜单 项 执行 的 默认 操作 。 如 果 自 定义 的 动作 提供 器 ， 
使 用 onPrepareSubMenu() 回 调 方法 创建 了 子 菜单 ,即使 把 这 个 动作 提供 器 放 在 溢出 菜 
单 中 , 子 菜单 也 会 显示 。 因 此 , 当 自 定义 动作 提供 器 中 子 菜单 存在 时 ,系统 不 会 回调 
onPerformDefaultAction() 方 法 。 
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对 于 应 用 中 不 同 视图 之 间 的 切换 和 展现 ,动作 条 上 的 导航 标签 是 一 个 很 好 的 工具 ,而 
且 导 航标 签 适合 在 不 同 的 屏幕 尺寸 上 显示 。 例 如 当 屏 幕 宽度 足够 ,导航 标签 就 显示 在 动 
作 按 钮 旁 的 动作 条 上 ;而 屏幕 较 罕 时 ,导航 标签 就 显示 在 分 离 的 横 条 中 ( 见 图 4. 10) 。 
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图 4.10 导航 标签 在 不 同 宽 度 屏幕 上 的 显示 


要 使 用 选项 标签 ,首先 用 户 界面 的 布局 定义 中 必须 包含 一 个 ViewGroup 对 象 ,用 于 
放置 跟 每 个 Fragment 对 象 关联 的 选项 标签 。 同 时 这 个 ViewGroup 对 象 需要 有 一 个 资源 
ID, 以 便 能 够 在 选项 标签 的 切换 代码 中 引用 它 。 如 果 选 项 标签 的 内 容 填充 在 Activity 的 
布局 中 , 则 此 Activity 不 需要 任何 布局 ,甚至 不 需要 调用 setContentView() 方 法 。 如 果 
把 每 个 Fragment 对 象 都 放 到 默认 的 根 ViewGroup 对 象 中 ,就 用 android. R. id. content 
ID 来 引用 这 个 ViewGroup 对 象 。 

Fragment 通常 作为 Activity 界面 的 一 部 分 组 成 出 现 ,并 可 将 它 的 Layout 提供 给 
Activity。Fragment 是 应 用 程序 的 一 部 分 ,可 以 用 Activity 来 替换 。 一 个 Activity 中 可 以 
同时 出 现 多 个 Fragment, 一 个 Fragment 也 可 在 多 个 Activity 中 使 用 。 在 Activity 运行 
过 程 中 ,可 以 添加 、 移 除 或 者 蔡 换 Fragment(add()、remove()、replace())。Fragment 可 
以 响应 自己 的 输入 事件 ,并 且 有 自己 的 生命 周期 ,但 直接 受 其 所 属 的 宿主 Activity 的 生命 
周期 影响 。 

Fragment 在 应 用 中 呈现 为 一 个 模块 化 和 可 重用 的 组 件 。 将 Fragment 包含 到 多 个 
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Activity 中 ,允许 应 用 程序 将 用 户 体 验 适 配 到 不 同 的 屏幕 尺寸 。 例 如 , 当 在 屏幕 尺寸 足够 
大 时 ,在 一 个 Activity 中 可 以 包含 多 个 Fragment, 相 反 , 应 用 程序 会 启动 另 一 个 使 用 不 同 
Fragment 的 Activity。 

决定 了 Fragment 对 象 在 布局 中 的 显示 位 置 后 ,添加 选项 标签 的 基本 过 程 如 下 。 

(1) 实现 ActionBar. TabListener 接口 。 这 个 接口 中 回调 方法 会 响应 选项 标签 上 的 
用 户 事件 ,例如 用 户 单 击 , 切 换 Fragment 对 象 。 

(2) 在 初始 化 Activity 时 ,对 每 个 要 添加 的 选项 标签 ,都 实例 化 一 个 ActionBar. Tab 
对 象 ,并 且 调 用 setTabListener() 方 法 设置 ActionBar. Tab 对 象 的 事件 监听 器 。 还 可 以 
用 setText() 或 setIcon() 方 法 来 设置 选项 标签 的 标题 或 图 标 。 

(3) 调用 addTab() 方 法 ,将 每 个 选项 标签 添加 到 动作 条 。 

ActionBar. TabListener 接口 的 回调 方法 并 没有 说 明 Fragment 和 Tab 之 间 的 联系 ， 
只 提供 了 被 选择 的 ActionBar. Tab 对 象 和 执行 Fragment 对 象 事务 的 Fragment- 
Transaction 对 象 。 因 此 ,必须 定义 每 个 ActionBar. Tab 与 Fragment 对 象 之 间 的 关联 。 
根据 设计 的 不 同 ,有 很 多 种 不 同 的 方法 来 定义 这 种 联系 。 

下 面 用 一 个 例子 来 说 明 如 何 实现 动作 条 上 的 导航 标签 。 

首先 ,定义 实现 ActionBar. TabListener 接口 的 Tab 监听 器 类 。 在 TabListener 监听 
器 中 ,定义 一 个 指定 Activity、Fragment 和 Fragment 类 型 的 构造 方法 ,实现 了 Tab 被 选 
择 、 被 重 选 和 不 选 几 个 动作 时 的 事件 处 理 ( 见 代码 4. 28) 。 

代码 4.28 实现 ActionBar. TabListener 接口 


public static class TabListener< T extends Fragment> implements ActionBar .TabListener { 
private Fragment mEragment; 
private final Activity mActivity; 
Private final String mTag; 
Private final Class< T>nClass; 


yx# Constructor used each time a new tab is created 
* @paramactivity The host Activity, used to instantiate the fragment 
* @paramtag The identifier tag for the fragment 
* @paramclz The fragment's Class, used to instantiate the fragment 
tf 
Public TabListener (Activity activity, String tag, Class<T> clz) { 
mctivity- activity; 
mrag- tag; 
nClass= clz; 
} 
/* The following are each of the ActionBar.TabListener callbacks* / 
Public void onTabSelected (Tab tab, FragnentTransaction ft) { 
//Check if the fragment is already initialized 
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然后 在 显示 这 个 动作 条 的 Activity 的 onCreate() 方 法 中 ,创建 动作 条 和 ActionBar. 
Tab 对 象 ,注册 TabListener 监听 器 到 ActionBar. Tab 对 象 ,并 添加 到 动作 条 ActionBar。 
另外 ,必须 调用 setNavigationMode(NAVIGATION_MODE_TABS) 方 法 来 让 选项 标签 
可 见 。 如 果 选 项 标签 的 标题 实际 指示 了 当前 的 View 对 象 , 就 可 以 通过 调用 
setDisplayShowTitleEnabled(false) 方 法 来 禁用 Activity 的 标题 。 代 码 4. 29 实现 了 两 个 
导航 标签 。 

代码 4.29 实现 导航 标签 
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this, "artist", ArtistFragment.class)); 
actionBar.addTab (tab); 


tab= actionBar.newTab() 
.setText (R.string.album) 
.setTabristener (new TabListener< RIbumFragment> ( 
this, "album", RIbumgragment.class))7 
actionBar.addrab (tab) ;} 


在 某 些 情况 下 ,Android 系统 会 把 动作 条 选项 标签 作为 一 个 下 拉 列 表 来 显示 ,以 便 确 
保 动作 条 的 最 优化 显示 。 

上 面 有 关 ActionBar. TabListener 的 实现 ,只 是 几 种 可 能 的 技术 之 一 。 在 API 
Demos 应 用 中 能 够 看 到 更 多 的 这 种 样式 。 


425 应 用 导航 模式 


Android 系统 在 3.0 之 后 ,提供 了 更 灵活 的 导航 方式 。 

1. 使 用 应 用 图 标 

应 用 图 标 是 ActionBar 四 个 区 域 中 的 第 一 个 区 域 ,表示 应 用 程序 的 标识 ,需要 时 可 以 
使 用 不 同 的 Logo 或 标牌 。 如 果 当 前 不 是 应 用 的 顶层 界面 , 则 在 图 标 左边 会 有 一 个 向 左 
的 箭头 ,表示 “向 上 ?按钮 ,使 用 户 可 以 回 到 上 一 级 界面 。 默 认 情 况 下 ,应 用 程序 图 标 显示 
在 动作 条 的 左边 ,可 以 作为 动作 选项 来 使 用 。 

在 这 个 应 用 图 标 上 ,应 用 程序 可 以 响应 如 下 两 种 操作 。 

(1) 返回 应 用 程序 的 主 Activity。 

(2) 向 应 用 程序 上 级 页 面 导航 导航 。 

当 用 户 触 摸 这 个 图 标 时 ,系统 会 回调 Activity 的 onOptionsItemSelected() 方 法 ,响应 
这 个 事件 ,进行 运行 对 应 的 程序 代码 。 在 事件 处 理 代码 中 , 既 可 以 实现 主 Activity, 也 可 
以 返回 应 用 程序 层次 结构 中 的 用 户 上 一 步 操作 界面 。 

1) 返回 应 用 程序 的 主 Activity 

如 果 要 通过 应 用 图 标的 事件 响应 来 返回 主 Activity, 则 需 在 事件 处 理 代 码 中 ,设置 
Intent 对 象 中 包括 FLAG_ACTIVITY_CLEAR_TOP 标识 。 使 用 这 个 标记 后 ,如 果 要 启 
动 的 Activity 在 当前 任务 中 已 经 存在 , 则 堆栈 中 这 个 Activity 之 上 的 所 有 的 Activity 都 
将 被 销毁 ,并 且 把 这 个 Activity 显示 给 用 户 。 

添加 这 个 标识 非常 重要 ,和 否则 在 响应 事件 时 ,系统 会 再 创建 一 个 新 的 主 Activity 实 
例 ,而 不 是 回 退 到 原 有 的 主 Activity, 最 终 可 能 会 造成 在 当前 任务 中 产生 一 个 很 长 的 拥有 
多 个 主 Activity 的 堆栈 。 添 加 这 个 标识 ,相当 于 一 个 堆栈 的 回 退 动作 ,重新 调 出 堆栈 中 原 
有 的 主 Activity 实例 。 

代码 4. 30 示例 了 在 onOptionsItemSelected() 方 法 中 的 事件 处 理 代 码 ,实现 了 返回 应 
用 程序 的 主 Activity 的 操作 。 
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代码 4.30 返回 应 用 程序 的 主 Activity 


@ Override 
public boolean cnoptionsTtemSelected MenuTtem item) { 
switch (item.getItemId()) { 
Case android.R.id.home: 
//app icon in action bar clicked; go home 
Intent intent= new Intent (this, HomeActivity.class); 
intent .addFlags (Intent.FIAG ACTIVITY CTERR TOP); 
startActivity (intent); 
retum true; 
Gefault: 
retum super.onOptionsItemSelected (item) ; 


为 了 适应 用 户 从 另 一 个 应 用 程序 进入 当前 Activity 的 情况 ,还 需要 添加 Intent 的 另 
一 个 FLAG_ACTIVITY_NEW_TASK 标识 ,使 用 户 在 返回 主页 或 上 级 页 面 时 ,系统 不 
会 把 新 的 Activity 添加 到 当前 的 任务 中 ,而 是 在 属于 自己 的 应 用 程序 任务 中 启动 。 

Android 4. 0 之 前 的 版 本 ,默认 情况 下 ,应 用 图 标 就 能 够 作为 一 个 操作 项 ;但 从 
Android 4.0 版 本 开始 ,如 果 要 使 用 应 用 图 标 来 返回 主页 ,必须 调用 ActionBar 的 方法 
setHomeButtonEnabled(true) ,来 设 定 应 用 图 标 能 够 作为 一 个 操作 项 。 

2) 向 应 用 程序 上 级 页 面 导航 

如 果 要 通过 应 用 图 标的 事件 响应 来 向 应 用 程序 上 级 页 面 导 航 ,就 需要 通过 调用 
ActionBar 的 SetDisplayHomeAsUpEnabledtrue(true) 方 法 ( 见 代 码 4. 31) ,在 onOptions- 
ItemSelected() 实现 事件 处 理 。 

代码 4.31 向 应 用 程序 上 级 页 面 导航 


Protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanoeState); 


SetContentView (R.layout .main); 
ActionBar actionBar= getActionBar (); 
actionBar. setDi splayHomeAsUrEnabled (true); 
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当 用 户 触 摸 这 个 图 标 时 ,系统 会 调用 带 有 android. R. id. home ID 的 onOptions- 
ItemSelected() 方 法 。 

2. 添加 下 拉 式 导航 

作为 Activity 内 部 的 另 一 种 导航 模式 ,动作 条 提供 了 内 置 的 下 拉 列 表 。 例 如 ,下 拉 列 
表 能 够 提供 Activity 中 内 容 的 不 同 排序 模式 。 
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启用 下 拉 式 导航 的 基本 过 程 如 下 。 


(1) 创建 一 个 给 下 拉 提供 可 选项 目的 列表 ,以 及 显示 选项 时 所 使 用 的 布局 。 
(2) 实现 ActionBar. OnNavigationListener 接口 ,定义 用 户 选项 时 的 事件 处 理 代码 。 


(3) 在 Activity 的 onCreate() 方 法 中 ,调用 setNavigationMode( ) 方 法 ,启用 动作 条 
的 下 拉 式 导航 模式 。 代 码 如 下 : 


(4) 用 ActionBar 的 setListNavigationCallbacks() 方 法 给 下 拉 列 表 设 置 回 调 方 法 。 
示例 代码 如 下 : 


这 个 方法 需要 SpinnerAdapter 和 ActionBar. OnNavigationListener 对 象 。 


下 面 使 用 一 个 简单 的 例子 来 说 明 如 何 具体 实现 下 拉 式 导航 ( 见 代码 4. 32) 。 
代码 4.32 ”实现 下 拉 式 导航 
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4.3 小 结 


本 章 主要 介绍 了 Android 系统 的 应 用 浏览 模式 中 菜单 和 动作 条 两 个 最 重要 的 组 件 。 

Android SDK 支持 丰富 的 菜单 类 型 ,包括 常规 的 菜单 . 子 菜单 、 上 下 文 菜单 .图 标 菜 
单 、 二 级 菜单 和 替代 菜单 。 其 中 选项 菜单 .弹出 菜单 和 上 下 文 菜单 是 菜单 的 三 个 基本 类 
型 。 菜 单项 由 android. view. Menultem 类 表示 , 子 菜单 由 android. view. SubMenu 类 表 
示 。 菜 单 的 创建 和 事件 处 理 与 其 他 视图 对 象 类 似 , 可 以 通过 XML 布局 文件 设计 菜单 ,使 
用 监听 器 或 菜单 的 回调 方法 来 处 理 菜单 选项 事件 。 

动作 条 (ActionBar) 是 位 于 Activity 顶端 的 一 个 图 形 控件 ,能 够 显示 Activity 的 标 
题 、 图 标 、 可 能 触发 的 动作 、 附 加 视图 和 其 他 交互 控件 ,也 可 以 用 于 在 应 用 程序 中 导航 。 对 
于 大 多 数 应 用 ,动作 条 可 以 分 割 为 应 用 图 标 、 视 图 控制 .动作 按钮 和 溢出 动作 四 个 不 同 的 
功能 区 域 。 

动作 条 可 以 与 许多 控件 结合 使 用 ,例如 菜单 、 视 图、 标签 和 内 容 提供 器 等 组 件 ,为 
Android 用 户 界面 提供 了 丰富 的 显示 模式 。 
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5.1 理解 Intent 


什么 是 Intent 呢 ? Intent 是 连接 Android 组 件 的 纽带 ,专门 用 于 携带 需要 传递 的 信 
息 。 当 某 个 组 件 创建 一 个 Intent 对 象 并 发 出 后 ,Android 系统 会 根据 Intent 携带 的 信息 
激活 对 应 的 其 他 组 件 ,也 就 是 启动 这 些 组 件 ,执行 这 些 组 件 的 代码 。Intent 对 象 中 同时 还 
携带 有 触发 其 他 组 件 执行 的 条 件 信息 和 触发 后 该 组 件 执行 时 所 需要 的 信息 。 
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由 于 Android 是 一 个 基于 有 限 资源 的 操作 系统 ,Android 的 基本 设计 理念 是 鼓励 减 
少 组件 的 耦合 ,因此 Android 提供 了 Intent 机 制 一 一 一 种 通用 的 消息 系统 。Android 的 
一 个 应 用 程序 与 其 他 的 应 用 程序 之 间 通 过 传递 Intent 对 象 来 执行 动作 和 产生 事件 。 通 
过 Intent 的 消息 触发 .消息 传递 ,消息 响应 来 实现 窗口 跳 转 、 传 递 数据 或 调用 外 部 程序 ， 
进行 应 用 程序 的 激活 和 调用 。 

Android 的 基础 组 件 Activity、Service 和 BroadcastReceiver, 都 可 以 通过 定义 Intent 
的 消息 ,实现 在 各 组 件 之 间 的 程序 跳 转 和 数据 传递 ,也 就 是 说 ,Intent 的 消息 可 以 激活 其 
他 组 件 。 从 程序 的 角度 来 看 ,在 Android 中 ,Intent 相当 于 各 个 Activity 之 间或 其 他 类 型 
基础 组 件 的 桥梁 ,可 以 传递 数据 ,还 可 以 通过 Intent 启动 另外 一 个 基础 组 件 。 

比如 说 从 一 个 窗口 单 击 一 个 链接 ,用 浏览 器 打开 另 一 个 页 面 时 , 既 要 启动 浏览 器 程 
序 ,又 要 把 链接 传递 给 浏览 器 ,这 时 Android 应 用 程序 就 可 以 在 第 一 个 Activity 中 创建 一 


个 Intent 对 象 ,在 Intent 对 象 把 链接 的 数据 封装 ,然后 通过 Android 系统 传递 给 浏览 器 
程序 ,并 启动 浏览 器 。 


抽象 地 说 ,Intent 消息 是 同一 个 应 用 程序 或 不 同 应 用 程序 运行 后 ,组 件 间 进行 绑 定 的 一 
种 能 力 。 通 过 Intent 消息 ,把 不 同 的 组 件 与 用 户 的 操作 联系 起 来 ,比如 说 在 一 个 Activity 上 
单 击 一 个 按钮 就 打开 另 一 个 显示 照片 的 Activity, 单 击 链接 则 打开 一 个 浏览 器 。 

具体 来 说 ,Intent 对 象 包含 要 执行 的 操作 或 需要 传递 的 消息 ,或 者 在 广播 的 情况 下 ， 
包含 一 些 已 经 发 生 或 正在 发 生 的 事情 的 描述 。 

举 个 例子 ,在 一 个 联系 人 维护 的 应 用 中 , 当 在 一 个 联系 人 列表 屏幕 (假设 对 应 的 
Activity 为 listActivity) 上 , 单 击 某 个 联系 人 后 ,希望 能 够 跳出 此 联系 人 的 详细 信息 屏幕 
(假设 对 应 的 Activity 为 detailActivity) ,在 两 个 Activity 之 间 , 需 要 传递 “联系 人 ”的 信 
息 , 这 个 工作 由 Intent 完成 。 下 面 来 看 看 Intent 具体 可 以 携带 哪些 信息 。 
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512 Intent 对 象 的 组 成 


一 个 Intent 对 象 就 是 一 个 信息 包 。 它 包含 了 接收 这 个 Intent 对 象 的 组 件 所 感 兴趣 
的 信息 (如 要 执行 的 动作 和 动作 相关 的 数据 ) 和 Android 系统 感 兴趣 的 信息 (如 处 理 这 个 
Intent 对 象 的 组 件 的 分 类 和 有 关 如 何 启动 目标 Activity 的 指令 )。Intent 为 这 些 不 同 的 
信息 定义 了 对 应 的 属性 ,通过 设 定 所 需 的 属性 值 ,就 可 以 把 数据 从 一 个 Activity 传递 到 另 
一 个 Activity。 

Intent 对 象 可 绑 定 信息 包含 下 面 这 些 。 

。 ComponentName: 需要 启动 的 Activity 的 名 字 。 

。 Action: 指定 了 要 访问 的 Activity 需要 做 什么 。 

。 Data: 需要 传递 的 数据 。 

Category: 给 出 一 些 Action 的 额外 执行 信息 。 
。 Extras: 需要 传递 的 额外 信息 ,以 键 值 对 形式 传递 。 
Flags: 标记 Activity 启动 的 方式 。 

但 是 Intent 对 象 在 绑 定 信息 时 ,并 不 是 所 有 的 信息 都 必须 设置 ,而 只 是 选 定 需要 携 
带 的 信息 绑 定 到 Intent 对 象 , 也 就 是 设 定 Intent 对 象 的 对 应 属性 的 值 。 

1. ComponentName 

Intent 的 组 件 名 称 对 象 由 ComponentName 类 封装 。 也 就 是 说 ,Intent 定义 了 一 个 属 
性 描述 Intent 将 要 激活 或 启动 的 Android 组 件 名 称 , 这 个 组 件 可 以 是 一 个 Activity、 
Service、Broadcast Receiver 或 者 Content Provider。Intent 的 这 个 属性 值 是 一 个 
ComponentName 类 的 对 象 ,我 们 无 法 直接 访问 它 , 但 可 以 通过 getComponentName() 
获取 。 

ComponentName 类 包含 两 个 String 成 员 , 分 别 代 表 Android 组 件 的 全 称 类 名 和 包 
名 , 包 名 必须 和 AndroidManifest. xml 文件 中 标记 中 的 对 应 信息 一 致 。 也 就 是 说 ,这 个 
Intent 对 象 所 要 激活 或 启动 的 Android 组 件 , 已 经 在 AndroidManifest. xml 中 进行 了 
描述 。 

对 于 Intent, 组 件 名 并 不 是 必需 的 。 如 果 一 个 Intent 对 象 添 加 了 组 件 名 , 则 称 该 
Intent 为 “ 显 式 Intent” ,这样 的 Intent 在 传递 的 时 候 会 直接 根据 组 件 名 去 寻找 目标 组 件 。 
如 果 没 有 添加 组 件 名 , 则 称 为 “ 隐 式 Intent”,Android 会 根据 Intent 中 的 其 他 信息 来 确定 
响应 该 Intent 的 组 件 。 打 个 比方 ,老师 在 让 学 生 回答 问题 时 ,老师 说 :“ 张 三 请 回答 问 
题 ”, 这 就 是 显 式 Intent, 直 接 指 出 了 回答 问题 的 人 ;老师 说 :“ 请 第 二 排 第 三 个 同学 回答 
问题 ”, 这 就 是 隐 式 Intent, 给 出 了 回答 问题 学 生 的 条 件 ,学 生根 据 自 己 的 座位 来 确认 是 谁 
来 回答 问题 。 

2. Action 

Action 是 描述 要 求 Android 系统 所 执行 动作 的 一 个 属性 , 值 是 一 个 字符 串 常 量 , 代 
表 Android 组 件 所 可 能 执行 的 一 些 操 作 , 比 如 说 启动 Activity ,发 出 警告 等 。Android 系 
统 中 已 经 预定 义 了 一 些 Action 常量 .开发 者 也 可 以 定义 自己 的 Action 描述 。Android 定 
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义 了 一 套 标 准 Action 的 值 ,其 中 最 重要 的 和 最 常用 的 Action 操作 是 ACTION_MAIN 和 


ACTION_EDIT, 见 表 5-1。 


表 5-1 标准 的 Action 操作 


标准 的 Activity Action 


标准 的 Broadcast Action 


ACTION_MAIN 
ACTION_VIEW 
ACTION_ATTACH_DATA 
ACTION_EDIT 
ACTION_PICK 
ACTION_CHOOSER 
ACTION_GET_CONTENT 
ACTION_DIAL 
ACTION_CALL 
ACTION_SEND 
ACTION_SENDTO 
ACTION_ANSWER 
ACTION_INSERT 
ACTION_DELETE 
ACTION_RUN 
ACTION_SYNC 
ACTION_PICK_ACTIVITY 
ACTION_SEARCH 
ACTION_WEB _ SEARCH 
ACTION_FACTORY_TEST 


ACTION_TIME_TICK 
ACTION_TIME_CHANGED 
ACTION_TIMEZONE_CHANGED 
ACTION_BOOT_COMPLETED 
ACTION_PACKAGE_ADDED 
ACTION_PACKAGE_CHANGED 
ACTION_PACKAGE_REMOVED 
ACTION_PACKAGE_RESTARTED 
ACTION_PACKAGE_DATA_CLEARED 
ACTION_UID REMOVED 
ACTION_BATTERY_CHANGED 
ACTION_POWER_CONNECTED 
ACTION_POWER_DISCONNECTED 
ACTION_SHUTDOWN 


假如 这 个 属性 定义 了 ACTION_MAIN 动作 , 则 表示 接收 Intent 对 象 传递 信息 的 
Activity 进行 初始 化 和 启动 操作 ,并且 不 需要 数据 输入 也 没有 返回 值 输出 。 

假如 这 个 属性 定义 了 ACTION_BATTERY_LOW 动作 , 当 电 池 电 量 低 时 ,系统 会 使 
用 Intent 对 象 传递 这 个 信息 给 Broadcast receiver 组 件 。 

下 面 是 Action 和 后 面 携带 相关 数据 的 例子 : 


ACTION VIEW content://contacts/pecple/1 
ACTION DIAL oontent://contacts/pecple/1 
ACTION DIAL tel:123 

RCTION EDIT oontent://contacts/people/1 
RCTION VIEW content://contacts/pecple/ 


-显示 标识 为 "1 的 联系 人 信息 
-=- 显 示 可 填写 的 电话 拨号 器 

- -显示 带 有 号 码 的 拨号 器 
-编辑 标识 为 "I" 的 联系 人 信息 
一 -显示 联系 人 列表 


在 Java 中 使 用 setAction() 来 设置 Intent 的 Action 属性 ,使 用 getAction() 来 获得 


Action 属性 。 
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3. Data 

Data 部 分 描述 了 Android 系统 执行 与 Action 相关 动作 时 ,所 激活 的 其 他 组 件 执行 时 
需要 的 数据 .数据 MIME 类 型 和 URI, 不 同 的 Action 对 应 不 同 的 操作 数据 。 例 如 ,如 果 
动作 字段 是 ACTION__EDIT ,数据 字段 将 包含 用 于 编辑 的 文档 的 URI; 如 果 动 作 是 
ACTION_CALL, 数 据 字 段 将 是 一 个 tel: URI 和 将 拨打 的 号 码 ; 如 果 动 作 是 ACTION_ 
VIEW ,数据 字段 是 一 个 http:URI, 接 收 Intent 的 组 件 将 下 载 或 显示 此 URI 指向 的 数据 。 

当 Android 系统 根据 一 个 Intent 匹配 对 应 的 组 件 时 ,知道 数据 的 类 型 ( 它 的 MIME 
类 型 ) 和 它 的 URI 很 重要 。 例 如 ,一 个 能 够 显示 图 像 数 据 的 组 件 , 就 不 应 该 在 播放 一 个 音 
频 文件 时 被 激活 。 

在 许多 情况 下 ,能 够 从 URI 中 推测 数据 类 型 ,特别 是 content:URI, 它 表示 位 于 设备 
上 的 数据 且 被 Content Provider 控制 。 但 是 也 能 够 显 式 地 设置 类 型 ,使 用 Intent 的 
setData() 方 法 指定 数据 的 URI,setType() 指 定 MIME 类 型 ,setDataAndType() 指 定数 
据 的 URI 和 MIME 类 型 。 被 激活 执行 的 Activity 中 ,获取 Intent 对 象 后 ,通过 Intent 的 
getData() 读 取 URI,getType() 读 取 类 型 。 

Data 部 分 的 数据 类 型 是 由 Action 的 值 决 定 的 ,下 面 给 出 几 个 例子 ,可 以 看 出 Action 
部 分 的 不 同 ,决定 了 数据 部 分 的 值 不 同 。 


ACTION VIEW content://contacts/1 -显示 标识 符 为 "的 联系 人 的 详细 信息 

ACTION EDIT content://contacts/1 -- 编 辑 标识 符 为 1" 的 联系 人 的 详细 信息 

ACTION VIEW content://contacts/ -- 显 示 所 有 联系 人 的 列表 

ACTION PICK content://contacts/ -- 显 示 所 有 联系 人 的 列表 ,并 且 人 允许 用 户 在 列表 中 选择 


一 个 联系 人 ,然后 把 这 个 联系 人 返回 给 父 Activity 
4. Category 
主要 描述 被 请 求 组 件 或 执行 行为 动作 的 额外 信息 。Android 系统 也 为 类 别 定义 了 一 
系列 的 静态 常量 字符 串 来 表示 Intent 不 同类 别 , 其 中 标准 的 类 别 定义 见 表 5-2。 
表 5-2 标准 的 Category 和 Extras 


标准 的 Category 标准 的 Extras 
CATEGORY_DEFAULT EXTRA_ALARM_COUNT 
CATEGORY_BROWSABLE EXTRA_BCC 
CATEGORY_TAB EXTRA_CC 
CATEGORY_ALTERNATIVE EXTRA_CHANGED_COMPONENT_NAME 
CATEGORY_SELECTED_ALTERNATIVE EXTRA_DATA_REMOVED 
CATEGORY_LAUNCHER EXTRA DOCK_STATE 
CATEGORY_INFO EXTRA DOCK_STATE HE DESK 
CATEGORY_HOME EXTRA_DOCK_STATE_LE_DESK 
CATEGORY_PREFERENCE EXTRA DOCK_STATE CAR 
CATEGORY_TEST EXTRA DOCK_STATE DESK 
CATEGORY_CAR DOCK EXTRA DOCK_STATE UNDOCKED 
CATEGORY_DESK_DOCK EXTRA_DONT_KILL_APP 
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续 表 
标准 的 Category 标准 的 Extras 
CATEGORY_LE_DESK_DOCK EXTRA_EMAIL 
CATEGORY_HE_DESK_DOCK EXTRA_INITIAL_INTENTS 
CATEGORY_CAR_MODE EXTRA_INTENT 
CATEGORY_APP_MARKET EXTRA_KEY_EVENT 


EXTRA_ORIGINATING_URI 
EXTRA_PHONE_NUMBER 
EXTRA_REFERRER 
EXTRA_REMOTE_INTENT_TOKEN 
EXTRA_REPLACING 
EXTRA_SHORTCUT_ICON 
EXTRA_SHORTCUT_ICON_RESOURCE 
EXTRA_SHORTCUT _INTENT 
EXTRA_STREAM 
EXTRA_SHORTCUT_NAME 
EXTRA_SUBJECT 
EXTRA_TEMPLATE 


EXTRA_TEXT 
EXTRA_TITLE 
EXTRA_UID 
5. Extras 
主要 描述 组 件 的 扩展 信息 或 额外 的 数据 。Android 也 定义 了 标准 的 Extra Data 常 
量 , 见 表 5-2。 


Extras 采用 键 值 对 的 结构 ,以 Bundle 对 象 的 形式 保存 在 Intent 中 。 附 加 信息 其 实 
是 一 个 类 型 安全 的 容器 ,其 实现 就 是 将 HashMap 做 了 一 层 封装 。 

Intent 对 象 有 一 系列 的 put…() 方 法 用 于 插入 各 种 附加 数据 和 一 系列 的 get…() 用 于 
读 取 数据 。 这 些 方 法 与 Bundle 对 象 的 方法 类 似 。 实 际 上 ,Extras 可 以 作为 一 个 Bundle， 
使 用 putExtras() 和 getExtras() 方 法 安装 和 读 取 。 

例如 ,如 果 要 执行 “发 送 电子 邮件 ?这 个 动作 ,可 以 将 电子 邮件 的 标题 .正文 等 保存 在 
Extras 里 , 传 给 电子 邮件 发 送 组 件 。 

6. Flags 

它 主 要 标识 如 何 触 发 目标 组 件 以 及 如 何 看 待 被 触发 的 目标 组 件 。 例 如 标识 被 触发 的 
组 件 应 该 属于 哪 一 个 任务 或 者 触发 的 组 件 是 否 是 最 近 的 Activity 等 。Flags 可 以 是 多 个 
标识 符 的 组 合 。 

Android 有 各 种 各 样 的 标志 ,许多 指示 Android 系统 如 何 去 启 动 一 个 活动 (例如 , 活 
动 应 该 属于 哪个 任务 ) 和 启动 之 后 如 何 对 待 它 ( 例 如 ., 它 是 否 属于 最 近 的 活动 列表 )。 所 有 
这 些 标志 都 定义 在 Intent 类 中 。 其 可 用 的 常量 包括 FLAG_ACTIVITY_CLEAR_TOP、 
FLAG_ ACTIVITY _ NEW _ TASK.\ FLAG _ ACTIVITY _ NO _ HISTORY.\ FLAG _ 
ACTIVITY_SINGLE_TOP。 
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当 一 个 Activity 创建 并 发 出 一 个 Intent 对 象 后 ,其 他 的 Activity 或 基础 组 件 可 能 因 
为 与 这 个 Intent 对 象 携带 的 信息 相关 而 被 启动 。 一 个 Acitvity 或 其 他 基础 组 件 实现 在 各 
组 件 之 间 的 程序 跳 转 和 数据 传递 ,可 以 通过 Intent 的 两 种 不 同方 式 来 实现 : 显 式 和 隐 式 。 

(1) 显 式 Intent: 指 在 Activity 或 其 他 组 件 创建 Intent 对 象 时 ,通过 Component 
Name 显 式 地 设 定 所 希望 启动 .激活 或 接收 这 个 Intent 对 象 的 目标 组 件 ( 如 Service) 名 称 ， 
当 这 个 Activity 发 送 这 个 Intent 对 象 后 ,由 Android 系统 自动 启动 或 激活 Component 
Name 指定 的 Android 组 件 , 接 收 这 个 Intent 对 象 携带 的 其 他 信息 。 因 为 有 时 开发 者 不 
知道 其 他 应 用 的 component 名 称 , 显 式 方式 常用 于 自己 应 用 内 部 的 消息 传递 ,例如 应 用 
中 一 个 Activity 启动 一 个 相关 的 Service 或 者 启动 一 个 相关 的 Activity。 

(2) 隐 式 Intent: 创建 Intent 对 象 的 组 件 , 并 不 指定 目标 组 件 的 名 字 , 即 
ComponentName 字段 为 空 , 当 这 个 Activity 发 送 这 个 Intent 对 象 后 ,Android 系统 通过 
Intent 对 象 中 的 其 他 信息 与 目标 组 件 的 Intent 过 滤器 中 的 设置 相 匹 配 ,来 启动 或 激活 相 
关 的 Activity、Service 或 Broadcast Receiver 等 目标 组 件 。 隐 式 Intent 经 常用 于 激活 其 他 
应 用 程序 中 的 组 件 。 

对 于 接收 隐 式 的 Intent 的 Android 组 件 来 说 ,需要 在 AndroidManifest. xml 中 设 定 
接收 Intent 对 象 的 策略 。 当 Android 系统 在 处 理 Intent 对 象 时 ,把 Intent 对 象 中 携带 的 
信息 与 应 用 程序 中 组 件 设 定 的 Intent 过 滤 策 略 逐 个 相 比较 ,判断 该 组 件 是 否 符合 启动 或 
接收 的 条 件 。 也 就 是 说 ,通过 设 定 Intent 过 滤 策 略 条 件 ,可 以 指示 Android 系统 在 什么 时 
候 启动 并 把 Intent 对 象 传递 给 自己 。 

下 面 是 一 个 使 用 Intent 过 滤器 的 例子 。 


< activity android:name= ".IntentExanpleActivity"> 
< intent— filter> 
< action android:name= "om.android.activity.MY ACTICON"/> 
< category android:name= "android.intent.category.DEFRULT"/> 
< /intent- filter> 
< /activity> 


这 是 在 AndroidManifest. xml 文件 中 IntentExampleActivity 的 声明 代码 。 当 系统 
中 其 他 的 Activity 发 送出 一 个 Intent 对 象 , 并 且 这 个 Intent 对 象 的 Action 属性 的 值 为 
MY_ACTION 时 ,Android 系统 会 启动 IntentExampleActivity 应 用 程序 。 

如 果 一 个 组 件 没有 声明 任何 Intent 过 滤器 , 它 仅 能 接收 显 式 的 Intents, 也 就 是 被 显 
式 Intent 对 象 启动 或 激活 ; 而 声明 了 Intent 过 滤器 的 组 件 可 以 接收 显 式 和 隐 式 的 
Intents 。 

并 非 Intent 对 象 中 所 有 的 信息 都 会 用 于 过 滤器 的 匹配 ,只 有 Action、Data( 包 括 URI 
和 数据 类 型 )、Category 三 个 字段 才 被 考虑 。 

下 面具 体 讨论 Intent 过 滤器 和 它 的 检测 方法 。 
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1. Intent 过 滤器 

Intent 过 滤器 是 由 intent-filter 标记 来 设置 的 。Activity、Service、BroadcastReceiver 
为 了 告知 Android 系统 能 够 处 理 哪 些 隐 式 Intent, 可 以 设置 一 个 或 多 个 条 件 ,说 明 该 组 件 
可 接收 的 Intent 对 象 ,过 滤 掉 不 想 接收 的 隐 式 Intent 对 象 。 

除了 BroadcastReceiver 通过 调用 Context. registerReceiver() 动 态 地 注册 ,直接 创建 
一 个 IntentFilter 对 象 外 ,其 他 的 Intent 过 滤器 必须 在 AndroidManifest. xml 文件 中 进行 
声明 。 可 用 于 Intent 过 滤器 的 Intent 字段 有 三 个 : Action .Data 和 Category。 

在 Android 系统 通过 组 件 的 Intent 过 滤器 检测 隐 式 Intent 时 ,要 检测 所 有 这 三 个 字 
段 ,其 中 任何 一 个 字段 匹配 失败 ,系统 都 不 会 把 这 个 隐 式 Intent 给 该 组 件 。 但 每 个 字段 
可 以 用 intent-filter 设置 多 个 条 件 ,每 个 设 定 的 条 件 之 间 相 互 独立 ,只 要 其 他 组 件 发 送出 
的 隐 式 Intent 对 象 符合 其 中 的 一 个 条 件 ,就 能 够 被 Android 系统 启动 或 接收 。 

2. Action 检测 

在 AndroidManifest. xml 文件 中 ,对 Action 字段 设置 过 滤 条 件 ,在 二 intent-filter> 
元 素 下 使 用 二 action 二 子 元 素 及 其 属性 android:name 来 设置 可 接收 的 Action 字段 的 值 。 
例如 : 


< intent- filter> 
< action android:name= "ocm.exanple.project..SHOW CURRENT"/> 
< action android:name= "om.exanple.project..SHOW RECENT"/> 
< action android:name= "ccm.exanple.project.SHOW_ PENDING"/> 
< /intent— filter> 


根据 例子 设置 的 过 滤 策 略 , 只 要 Action 字段 的 值 符合 上 面 列 出 之 一 的 Intent, 都 可 
以 被 这 个 组 件 接收 。 虽 然 一 个 Intent 对 象 的 Action 只 有 一 个 值 ,但 是 一 个 过 滤器 可 以 列 
出 不 止 一 个 ,接收 多 种 类 型 Action 的 Intent 对 象 。 

值得 注意 的 是 ,一 intentrfilter 之 元 素 下 必须 至 少 包含 一 个 二 action 二 子 元 素 , 否 则 它 
将 阻塞 所 有 的 Intent。 要 通过 检测 ,Intent 对 象 中 指定 的 动作 必须 匹配 Intent 过 滤器 的 
action 列表 中 的 一 个 。 如 果 过 滤器 没有 < 王 action 二 子 元 素 , 将 没有 一 个 Intent 匹配 ,所 有 
的 Intent 都 会 检测 失败 ,没有 Intent 能 够 通过 过 滤器 。 

3。Category 检测 

类 似 Action 检测 ,在 一 intentrfilter 二 元 素 下 使 用 一 category 二 子 元 素 及 其 属性 
android:name 列 出 可 接收 的 Category 字段 的 值 , 例 如 : 


< intent- filter …> 
< category android:name= "android.intent.category.DEFRULT"/> 
< category android:name= "android.intent .category.BROWSABIE"/> 


< /intent— filter> 


在 Intent 对 象 中 可 以 含有 多 个 Category, 二 intent-filter 二 中 可 以 设置 多 个 
< 一 category 二 , 只 有 Intent 中 的 所 有 Category 都 能 匹配 到 到 intentrfilter 二 中 的 
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过 category 之 ,Intent 才能 通过 检测 。 也 就 是 说 ,如 果 Intent 对 象 中 的 Category 集合 是 
<intentrfilter 过 中 二 category 过 的 集合 的 子 集 时 ,Intent 对 象 才能 通过 检查 。 如 果 Intent 
对 象 中 没有 设置 Category 的 值 , 则 它 能 通过 所 有 二 intentfilter 之 的 一 category 二 检查 。 

如 果 一 个 Intent 能 够 通过 不 止 一 个 组 件 的 二 intentfilter 二 ,系统 可 能 会 询问 哪个 组 
件 被 激活 。 如 果 找 不 到 目标 组 件 , 就 会 产生 一 个 异常 。 

4. Data 检测 

类 似 地 ,在 一 intentr-filter 盖 元 素 下 使 用 一 data 过 元素 及 其 属性 可 接收 的 Data 字段 的 
值 ,例如 : 


< intent— filter …> 
< data android:mimeType= "video/mpeg" android:scheme= "http" … /> 
< data android:mimeType= "audio/mpeg" android:scheme= "http" *… /> 


</intent- filter> 


每 个 二 data 志 元 素 可 以 指定 一 个 URI 和 数据 类 型 (MIME 类 型 )。 对 应 于 URI 的 
scheme、host、port、 path 等 4 个 部 分 ,一 data 二 元 素 分 别 使 用 属性 android: scheme、 
android:host\android:port android:path 来 设置 。 下 面 是 URI 的 格式 和 一 个 例子 。 


scheme://host:port/path 
content://com.exanple.project:200/folder/subfolder/etc 


scheme 是 content, host 是 com. example. project, port 是 200, path 是 folder/ 
subfolder/etc。host 和 port 一 起 构成 URI 的 凭据 (authority) ,如 果 host 没有 指定 ,port 
也 被 忽略 。 这 4 个 属性 都 是 可 选 的 ,但 它们 之 间 并 不 都 是 完全 独立 的 。 要 让 authority 有 
意义 ,scheme 必须 也 要 指定 。 要 让 path 有 意义 ,scheme 和 authority 也 都 必须 指定 。 

当 比 较 Intent 对 象 和 过 滤器 的 URI 时 ,仅仅 比较 过 滤器 中 出 现 的 URI 属性 。 例 如 ， 
如 果 一 个 过 滤器 仅 指 定 了 scheme, 所 有 有 此 scheme 的 URI 都 匹配 过 滤器 ;如 果 一 个 过 
滤器 指定 了 scheme 和 authority, 但 没有 指定 path, 所 有 匹配 scheme 和 authority 的 URI 
都 通过 检测 ,而 不 管 它们 的 path; 如 果 4 个 属性 都 指定 了 ,要 都 匹配 才能 算是 匹配 。 然 
而 ,过 滤器 中 的 path 可 以 包含 通配符 来 要 求 匹配 path 中 的 一 部 分 。 

去 data> 元 素 的 mimeType 属性 指定 数据 的 MIME 类 型 。Intent 对 象 和 过 滤器 都 可 
以 用 * 通配符 匹配 子 类 型 字段 ,例如 text/ * ,audio/ * 表示 任何 子 类 型 。 

在 Data 检测 时 ,系统 既 要 检测 URI. 也 要 检测 MIME 类 型 。 检 测 的 规则 如 下 。 

(1) 一 个 Intent 对 象 既 不 包含 URI, 也 不 包含 MIME 类 型 : 仅 当 过 滤器 也 不 指定 任 
何 URI 和 MIME 类 型 时 ,才能 通过 检测 。 

(2) 一 个 Intent 对 象 包含 URI, 但 不 包含 MIME 类 型 : 仅 当 过 滤器 也 不 指定 MIME 
类 型 ,同时 它们 的 URI 匹配 ,才能 通过 检测 。 例 如 ,mailto: 和 tel: 都 不 指定 实际 数据 。 

(3) 一 个 Intent 对 象 包含 MIME 类 型 ,但 不 包含 URI: 仅 当 过 滤器 也 只 包含 MIME 
类 型 且 与 Intent 相同 , 才 通过 检测 。 


Ve/ 基于 Adoid 平 台 的 移动 互联 网 开发 


(4) 一 个 Intent 对 象 既 包含 URI, 也 包含 MIME 类 型 (或 MIME 类 型 能 够 从 URI 推 
断 出 ): MIME 类 型 部 分 ,只 有 与 过 滤器 中 之 一 匹配 才 算 通 过 ;URI 部 分 , 它 的 URI 要 出 
现在 过 滤器 中 ,或 者 它 有 content: 或 file: URI, 又 或 者 过 滤器 没有 指定 URI。 换 句 话 说 ， 
如 果 它 的 过 滤器 仅 列 出 了 数据 类 型 ,组件 假定 支持 content: 和 file: 。 

如 果 一 个 Intent 能 够 通过 不 止 一 个 组 件 的 二 Intent-filter> ,系统 可 能 会 询问 哪个 组 
件 被 激活 。 如 果 找 不 到 目标 组 件 , 就 会 产生 一 个 异常 。 

例如 ,Android 一 个 名 为 Note Pad 的 应 用 程序 ,允许 用 户 浏览 便签 ,查看 每 条 便签 的 
内 容 。 这 个 程序 在 manifest 文件 中 可 以 按 代码 5. 1 来 设置 Intent 过 滤器 ,使 其 可 以 根据 
需要 被 系统 激活 。 

代码 5.1 应 用 程序 的 Intent 过 滤器 设置 
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在 代码 5. 1 中 ,可 知 此 应 用 程序 定义 了 3 个 Activity, 每 一 个 Activity 都 定义 了 多 个 
Intent 模板 。 其 中 命名 为 com. android. notepad. NotesList 的 第 一 个 Activity 作为 进入 
应 用 程序 的 主人 口 ,通过 定义 3 个 Intent 过 滤器 ,可 以 做 3 件 事情 。 


第 一 个 Intent 过 滤 模 板 代码 如 下 : 
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< category android:name= "android.intent.category-IADNCHFER"/> 
< /intent— filter> 


Action 设置 为 标准 MAIN ,表示 这 个 Activity 提供 了 进入 NotePad 应 用 程序 的 顶级 
入 口 ,Category 设置 为 LAUNCHER 表示 这 个 入 口 应 该 列 入 应 用 程序 启动 列表 。 
第 二 个 Intent 过 滤 模 板 代码 如 下 : 


< intent- filter> 

< action android:name= "android.intent .action.VIEW"/> 

< action android:name= "android.intent .action.EDIT"/> 

< action android:name= "android.intent .action.PICK"/> 

< category android:name= "android. intent .category. [DEFAULT"/> 

< data mimeType:name= "vnd.android.cursor.dir/vwnd.google.note"/> 
< /intent— filter> 


Action 设置 为 VIEW、EDIT 和 PICK 表示 这 个 Activity 可 以 对 便签 目录 所 作 的 操 
作 , 允 许 用 户 浏览 ,编辑 和 挑选 便签 。Category 设置 DEFAULT 表示 ,如 果 这 个 Activity 
的 组 件 名 没有 显 式 说 明 , 还 需要 通过 Context. startActivity() 方 法 来 启动 这 个 Activity。 
第 三 个 Intent 过 滤 模板 代码 如 下 : 


< intent- filter> 

< action android:name= "androiqd.intent.action.GET CONTENT"/> 

< category android:name= "android.intent.category.DEFRULT"/> 

< data android:mimeType= "vnd.android.cursor.item/vnd.google.note"/> 
< /intent- filter> 


vnd. android. cursor. item/vnd. google. note 是 指示 vnd. android. cursor. item 资源 中 
确切 指定 的 一 个 URI, 也 就 是 vnd. google. note。Data 的 type 的 设置 表示 指定 类 型 的 数 
据 可 以 被 这 个 Activity 检索 。action 设置 为 GET_CONTENT 与 PICK 类 似 。 这 个 设置 
表示 当 type 为 vnd. android. cursor. item/vnd. google. note 时 ,返回 给 调用 者 一 个 用 户 选 
择 的 便签 ,而 用 户 不 需要 知道 便签 从 哪里 读 取 的 。 

通过 这 三 个 过 滤 模 板 的 设置 ,如 果 系统 中 出 现 携带 下 面 信息 的 Intent,NotesList 这 
个 activity 就 会 被 激活 执行 。 

{ action= android.app.action.MAIN } 

与 此 Intent 匹配 的 Activity, 将 会 被 当 作 进入 应 用 的 顶级 入 口 。 

{ action= android.app.action.MAIN, category= android.app.category.IAUNCHER } 

这 是 目前 Launcher 实际 使 用 的 Intent, 用 于 生成 Launcher 的 顶级 列表 。 

{ action= android.app.action.VIFN datar content://coam.google-provider.NotePad/notes } 


显示 content://com. google. provider. NotePad/notes 下 的 所 有 便 敌 的 列表 ,使 用 者 


可 以 遍历 列表 ,并 且 查 看 某 便 复 的 详细 信息 。 
{ action= android.app.action.PICK data= content://coam.google-provider .NotePad/notes } 


显示 content://com. google. provider. NotePad/notes 下 的 便签 列表 ,让 用 户 可 以 在 
列表 中 选择 一 个 ,然后 将 选择 的 便签 的 URL 返回 给 调用 者 。 


{ action= android.app.action.GET ONTENT type= vnd.android.cursor.item/vnd.google.note } 


下 面 用 实际 的 例子 来 创建 Intent, 使 用 显 式 和 隐 式 Intent 激活 其 他 组 件 ,加 深 对 
Intent 组 件 的 理解 ,了 解 如 何 利 用 Intent 在 Activity 之 间 传 递 数据 。 
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使 用 Intent 实现 数据 传递 无 论 是 显 式 还 是 隐 式 ,都 需要 有 以 下 几 个 步 又。 

(1) 定义 传递 数据 的 Activities, 也 就 是 通过 布局 文件 设计 Activity 的 界面 ,并 创建 相 
互 转换 的 几 个 Activity, 它 们 之 间 需 要 数据 转换 或 需要 在 某 种 情况 下 进行 切换 。 

(2) 在 Activity 中 创建 Intent, 设 定 所 传递 元 素 的 值 , 即 需 传递 的 数据 ;或 者 设 定 所 要 
切换 的 Activity。 

(3) 声明 Activity 以 及 Intent 过 滤器 ,这 一 步 在 manifest. xml 中 声明 所 创建 的 
Acetivity, 并 且 根据 显 式 还 是 隐 式 的 设置 设 定 相应 的 Intent filter。 

下 面 用 例子 说 明 Intent 如 何在 Activity 之 间 起 作用 。 

1. 使 用 显 式 定义 Intent 

使 用 显 式 定义 Intent, 实 现 About 对 话 框 功能 : 

。 在 主页 面 ,用 户 单 击 About 按钮 时 ,弹出 一 个 对 话 框 ,显示 有 关 移 动 电子 商务 平台 

的 信息 。 

。 在 About 对 话 框 , 单 击 OK 按钮 ,返回 主页 面 。 

下 面 先 给 出 关键 的 Intent 创建 代码 ,方便 在 完整 的 程序 代码 中 查看 。 这 里 直接 给 出 
了 Intent 的 组 件 名 称 属性 。 


// 显 式 方式 声明 Intent, 直 接 启 动 
SecondActivityIntentit= newIntent (MainActivity.this, AboutActivity 
“Class)7 

// 肩 动 aetivity 

startActivity (it); 


完成 这 个 功能 ,需要 如 下 几 个 步骤 。 
(1) 定义 主 Activity 的 布局 ,设置 一 个 显 式 信息 的 文本 框 TextView 和 About 按钮 ， 
见 代 码 5.2。 
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代码 5.2 explicit_intent_main_layout. xml 


(2) 定义 单 击 按钮 后 出 现 的 第 二 个 Activity 的 布局 ,设置 一 个 显 式 信息 的 文本 框 
TextView 和 OK 按钮 , 见 代 码 5. 3。 
代码 5.3 explicit_intent_second_layout. xml 


(3) 定义 主 Activity, 导 入 布局 资源 定义 的 界面 ,并 在 OnClickListener() 方法 中 编写 


单 击 按钮 后 的 事件 处 理 代码 , 见 代码 5. 4。 
代码 5.4 ExplicitMainActivity. java 
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(4) 定义 第 二 个 用 户 界 面 Activity, 导 入 布局 资源 定义 的 界面 ,并 在 OnClickListener() 
方法 中 编写 单 击 OK 按钮 后 的 返回 主 界面 的 事件 处 理 代码 , 见 代码 5. 5。 
代码 5.5 ExplicitSecondActivity. java 
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完成 上 述 4 步 之 后 ,在 AndroidManifest. xml 中 注册 ,运行 此 程序 ,可 以 看 到 通过 显 
式 Intent 的 作用 ,可 以 在 两 个 界面 之 间 跳 转 。 通 过 这 个 例子 可 以 看 出 ,所 谓 显 式 Intent， 
就 是 通过 创建 Intent 对 象 , 直 接 告诉 系统 要 启动 哪 一 个 Activity 或 其 他 组 件 。 

2. 使 用 隐 式 定义 Intent 

在 上 面 的 例子 中 ,我 们 使 用 显示 Intent 实现 了 界面 的 跳 转 。 下 面 尝 试用 隐 式 Intent 
来 实现 上 个 例子 同样 的 功能 ,学 习 Action 检测 的 使 用 。 

下 面 先 给 出 关键 的 Intent 创建 代码 ,方便 在 完整 的 程序 代码 中 查看 。 


在 Androidmanifest. xml 的 主 界面 声明 中 的 代码 如 下 :; 


完成 这 个 功能 ,需要 如 下 几 个 步骤 。 

(1) 定义 主 Activity 的 布局 ,设置 一 个 显 式 信息 的 文本 框 TextView 和 About 按钮 ， 
见 代码 5. 2。 

(2) 定义 单 击 按钮 后 出 现 的 第 二 个 Activity 的 布局 ,设置 一 个 显 式 信息 的 文本 框 
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TextView 和 OK 按钮 , 见 代码 5. 3。 


(3) 定义 主 Activity, 导 入 布局 资源 定义 的 界面 ,并 在 OnClickListener() 方法 中 编写 
单 击 按钮 后 的 事件 处 理 代码 ,创建 Intent 对 象 ,设置 Intent 对 象 的 Action 字段 的 值 为 
com. android. activity. MY_ACTION, 见 代码 5. 6。 

代码 5.6 ImplicitMainActivity. java 


(4) 定义 第 二 个 用 户 界面 Activity, 导 入 布局 资源 定义 的 界面 , 见 代码 5.7。 
代码 5.7 ImplicitSecondActivity. java 
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@ Override 

Protected void onCreate (Bundle savedInstanoeState) { 
super.onCreate (savedInstanoeState); 
setContentView 人 -layout- implicit intent second layout); 


上 


3. 使 用 Intent 传递 和 获取 数据 

无 论 是 显 式 还 是 隐 式 Intent, 除 了 可 以 启动 和 激活 其 他 的 组 件 之 外 ,还 可 以 同时 携带 
需要 传递 到 另 一 个 组 件 的 信息 ,比如 说 在 一 个 Activity 中 提供 给 用 户 输入 界面 ,完成 的 多 
个 信息 输入 ,然后 启动 男 一 个 Activity, 在 第 二 个 Activity 上 进行 信息 的 处 理 和 输出 。 要 
实现 这 种 功能 ,可 以 在 第 一 个 Activity 创建 Intent 对 象 , 设 置 Intent 的 启动 条 件 , 也 就 是 
设置 显 式 Intent 或 隐 式 Intent 的 过 滤 条 件 , 同 时 把 用 户 输入 的 信息 也 放 入 这 个 Intent。 
这 样 在 第 二 个 Activity 接收 这 个 Intent 时 ,就 可 以 从 Intent 对 象 中 读 出 用 户 输入 的 信息 。 
类 似 的 信息 可 以 在 Intent 对 象 的 Extra 字段 中 存储 。 

下 面 这 个 例子 实现 在 FirstActivity 和 SecondActivity 之 间 传 递 用 户 输入 信息 的 


功能 。 
。 在 主页 面 , 用 户 单 击 About 按钮 时 ,弹出 一 个 对 话 框 ,显示 有 关 移 动 电子 商务 平台 
的 信息 。 


。 在 About 对 话 框 , 单 击 OK 按钮 ,返回 主页 面 。 

代码 5. 8 在 这 里 给 出 Intent 对 象 设置 的 主要 代码 ,可 以 按照 前 面 隐 式 的 Intent 使 用 
方式 来 编写 布局 文件 和 完整 的 应 用 程序 。 

代码 5.8 Intent 传递 和 获取 数据 


FirstActivity: 
Intenti= newIntent (this, ActivitySeoond.class); 
i.putExtra ("Valuel", "ThisvalueoneforActivityIwo") ; 
i.putExtra ("Value2", "ThisvaluetwoActivityIwo") 7 
startActivityForResult (i, REOUEST CODE); 


Secondactivity 
Bundleextras= getIntent () .getExtras () 7 
Stringvaluel= extras.getString ("Valuel"); 
Stringvalue2= extras.getString ("Value2"); 


4. 通过 Intent 启动 系统 应 用 Activities 

通过 Intent 不 仅 可 以 启动 本 项 目 中 的 应 用 程序 ,还 可 以 通过 不 同 的 设 定 ,启动 系统 
提供 的 应 用 程序 ,利用 系统 定义 的 功能 。 具 体 的 启动 和 激活 方式 ,可 以 使 用 显 式 Intent， 
也 可 以 使 用 隐 式 Intent 的 Action、Category 和 Data 的 任意 一 种 过 滤 条 件 设置 。 

例如 ,在 下 面 的 代码 中 ,定义 了 一 个 URI,. 并 把 这 个 URI 作为 新 创建 的 Intent 对 象 的 
Data ,并 将 Intent 的 Action 设置 为 ACTION_VIEW。 通过 这 样 的 设置 ,当前 的 Activity 
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发 送出 这 个 Intent 之 后 ,就 可 以 启动 系统 的 浏览 器 ,并 通过 浏览 器 打开 http://open 
. taobao. com 这 个 链接 的 网 页 。 


下 面 的 例子 定义 了 一 个 单 选 列 表 界 面 ,简单 调用 浏览 器 .电话 拨号 .日历 等 系统 应 用 
程序 。 通 过 这 个 例子 ,可 以 了 解 如 何 利 用 Intent 启动 和 激活 常用 的 系统 应 用 程序 。 

首先 定义 应 用 程序 的 界面 布局 ( 见 代 码 5. 9), 然 后 创建 用 户 界面 Activity( 见 代 
码 5.10)。 

代码 5.9 to_system_intent _layout. xml 
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代码 5.10 ToSystemActivity. java 


第 5 章 “发 送 和 接收 消息 加 人 


Ve 基于 Android 平台 的 移动 互联 网 开发 


} 
if (intent!=nu11) { 
StartActivity (intent); 
} 
} 


@ Override 
piblic void opetivityResult (int reqyestOode, int reeultCbde， Intent data) { 
证 (resultCode==Rctivity.RESUTT OK && requestCode==0) { 
String result= data.toURI (); 
Toast .makeText (this，result，Toast.IENGTH IONG); 


} 


前 面 只 列 出 了 主要 的 布局 文件 代码 和 Activity 定义 的 代码 ,如 果 要 程序 顺利 正常 执 
行 ,还 需要 定义 字符 串 等 资源 ,Activity 也 需要 在 AndroidMenifest. xml 文件 中 注册 。 

通过 前 面 的 4 个 例子 ,我 们 讨论 了 如 何 运用 Intent 对 象 启动 和 激活 其 他 的 组 件 , 如 何 
在 组 件 之 间 发 送 和 接收 消息 。 在 应 用 程序 设计 中 ,可 以 根据 需要 灵活 运用 Intent 的 各 种 
功能 。 


5.2 BroadcastReceiver 组 件 


5.2.1 BroadcastReceiver 的 概念 


广播 是 一 种 广泛 运用 在 应 用 程序 之 间 传 输 信息 的 机 制 。BroadcastReceiver 是 
Android 系统 中 负责 接收 广播 消息 并 对 消息 做 出 反应 的 组 件 。 可 以 将 BroadcastReceiver 
理解 为 广播 接收 者 ,用 于 接收 程序 所 发 出 的 承载 各 种 各 样 广播 消息 的 Intent。 它 在 本 质 
上 相当 于 一 个 监听 器 ,监听 接收 广播 消息 ,然后 再 做 出 处 理 。 广 播 消 息 既 可 以 是 系统 发 
出 ,也 可 以 由 用 户 应 用 程序 产生 。 

多 数 的 广播 是 系统 发 起 的 ,如 地 域 变 换 、 电 量 不 足 、 来 电 来 信 等 。 程 序 也 可 以 播放 一 
个 广播 。BroadcastReceiver 没有 用 户 界面 ,可 以 在 接收 到 信息 后 启动 Activity 或 者 通过 
NotificationManger 通知 用 户 ,也 可 以 通过 其 他 多 种 方式 通知 用 户 , 例 如 开启 背景 灯 、 振 
动 设备 .播放 声音 等 ,最 典型 的 是 在 状态 栏 显示 一 个 图 标 , 这 样 用 户 就 可 以 单 击 它 打开 看 
通知 内 容 。 

如 果 是 用 户 应 用 程序 发 送 广播 消息 ,在 Intent 对 象 创 建 后 ,启动 BroadcastRecevicer 
的 方式 有 两 种 : 通过 sendBroadcast() 方 法 启动 和 通过 sendOrderedBroadcast() 方 法 启 
动 。 这 两 者 的 区 别 就 是 前 者 是 发 送 一 个 普通 的 广播 ,后 者 是 发 送 一 个 有 序 的 广播 。 

BroadcastReceiver 在 Android 应 用 程序 中 ,与 其 他 三 大 组 件 Activity、 Service 和 
Content Provider 一 样 ,是 以 一 段 独立 的 Java 程序 代码 存在 于 应 用 程序 项 目 中 ,如 果 在 程 
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序 中 能 够 启动 和 运行 ,必须 要 在 Android 项 目 中 注册 。 

注册 BroadcastReceiver 有 如 下 两 种 方式 。 

(1) 静态 注册 : 在 AndroidManifest. xml 中 用 标签 注册 ,并 在 标签 内 用 标签 设置 过 滤 
器 。 例 如 ,静态 注册 命名 为 myRecevicer 的 BroadcastReceiver 的 代码 如 下 。 


< receiver android:name= "myRecevicer"> 
< intent— filter> 
< action android:name= "om.dragon.net"> < /action> 
< /intent— filter> 
< /receiver> 


(2) 动态 注册 : 除了 上 面 这 种 静态 的 注册 方式 之 外 ,BroadcastReceiver 也 可 以 通过 
动态 的 方式 注册 ,通过 Context. registerReceiver() 方法 来 实现 。 动 态 实现 注册 的 类 必须 
是 BroadcastReceiver 的 子 类 。 对 应 于 静态 注册 例子 的 动态 代码 如 下 。 


TIntentFilter intentFilter= new IntentFilter(); 
intentFilter .addAction (String); 
TegisterReceiver (BroadcastReoeiver, intentFilter); 


如 果 要 使 用 BroadcastReceiver 的 功能 ,首先 在 需要 发 送信 息 的 地 方 创建 Intent 对 
象 ,把 要 携带 的 信息 和 用 于 过 滤 的 信息 载 人 Intent 对 象 中 ,然后 通过 调用 sendOrder- 
Broadcast() 或 sendStickyBroadcast() 方 法 ,把 Intent 对 象 以 广播 方式 发 送出 去 。 

当 Intent 发 送 以 后 ,所 有 已 经 注册 的 BroadcastReceiver 会 检查 注册 时 的 IntentFilter 
是 否 与 发 送 的 Intent 相 匹配 , 若 匹配 就 会 调用 BroadcastReceiver 的 onReceive( ) 方 法 。 
所 以 当 定义 一 个 BroadcastReceiver 的 时 候 , 都 需要 实现 onReceive( ) 方 法 。 

Android 系统 中 定义 了 很 多 标准 的 广播 动作 来 响应 系统 的 广播 事件 , 见 表 5-1。 需 要 
时 这 些 Action 可 以 在 应 用 程序 中 直接 付 给 Intent 的 Action 字段 。 

下 面 分 别 通 过 简单 的 例子 来 学 习 在 应 用 程序 中 其 他 组 件 如 何 创建 和 使 用 Broadcast 
消息 ,如何 使 用 不 同 的 注册 方式 来 设置 BroadcastReceiver 的 过 滤 条 件 , 处 理 广播 信息 ,如 
何 使 用 BroadcastReceiver 来 处 理 系统 广播 信息 。 
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BroadcastReceiver 在 AndroidManifest. xml 文件 中 进行 静态 注册 ,使 用 二 application 二 
元 素 的 子 元 素 一 receiver 二 注册 要 使 用 的 BroadcastReceiver, 并 在 一 receiver 二 的 子 元 素 
< 一 intentrfilter 盖 中 定义 过 滤 条 件 ,确定 接收 处 理 哪 一 类 的 Intent。 

如 果 BroadcastReceiver 采用 静态 方式 注册 ,无论 该 项 目的 应 用 程序 是 否 处 于 活动 状 
态 ,都 会 进行 监听 。 例 如 某 个 程序 设 定 监听 电池 使 用 情况 的 BroadcastReceiver, 当 程序 在 
手机 上 安装 好 后 ,不 管 这 个 应 用 程序 是 处 于 什么 状态 , 当 收 到 系统 广播 的 或 其 他 应 用 程序 
广播 的 有 关 电 池 使 用 状况 的 内 容 , 都 会 执行 其 onReceive() 中 的 内 容 。 

下 面 的 例子 定义 了 一 个 BroadcastReceiver, 当 其 接收 到 一 个 广播 消息 , 即 应 用 程序 发 
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送出 的 一 个 广播 Intent, 它 的 Action 字段 是 RECEIVER_ACTION 时 ,对 这 个 广播 消息 
事件 进行 处 理 , 在 其 onRecieve() 方 法 中 把 这 个 Intent 的 有 关 信 息 写 入 日 志 。 

要 实现 这 个 例子 的 功能 ,需要 做 下 面 一 些 工 作 。 

(1) 定义 发 送 广播 Intent 的 界面 ,包括 布局 文件 main. xml 和 Activity。 

(2) 定义 BroadcastReceiver, 处 理 广播 消息 。 

(3) 在 AndroidManifest. xml 中 注册 所 定义 的 BroadcastReceiver, 定 义 其 过 滤器 。 

首先 定义 用 户 发 送 广播 界面 的 布局 文件 main. xml( 见 代码 5. 11) ,在 界面 上 定义 一 
个 按钮 ,使 其 显示 出 如 图 5. 1 所 示 的 界面 。 


BroadcastReceiver 


5.1 BroadcastReceiver 界面 


代码 5.11 main. xml 


< ?al version= "1.0" enooding= "utf- 8"?> 
< LinearTLayout xmlns:android "http://schemas.android.om/apk/res/android" 
android:orientation= "vertical" 
android:layout width= "fil1 parent" 
android:layout_ height= "fill parent" 
2 
<Button 
android:idF "@ + id/btnBroadcast" 
android:layout widthr= "match parent™" 
android: layout. height= "wrap oontent" 
android:text= "发 送 Broadcast" 
/> 
< /LinearTayout> 


图 5.1 界面 是 这 个 例子 的 用 户主 界面 ,其 中 的 按钮 用 于 控制 广播 消息 Intent 的 创建 
和 发 送 。 在 定义 界面 的 Activity 中 导入 布局 文件 后 ,在 按钮 事件 处 理 代码 中 创建 一 个 
Intent, 进 行 Action 设置 ,并 使 用 sendBroadcast() 发 送 这 个 Intent, 产 生 一 个 广播 消息 , 见 
代码 5. 12。 

代码 5.12 TestStaticReceiverActivity. java 


import android.app.activity; 
import android.content.Intent; 
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完成 创建 和 发 送 广播 消息 的 功能 之 后 ,需要 定义 一 个 BroadcastReceiver 来 处 理 所 发 
出 的 广播 消息 ,实现 广播 日 志 的 填写 。 

定义 一 个 MyReceiver 类 ,继承 于 BroadcastReceiver ,覆盖 onReceive() 方 法 ,在 其 中 
实现 写 日 志 操作 , 见 代 码 5. 13。 

代码 5.13 MyReceiver. java 
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定义 创建 广播 消息 的 Activity 和 处 理 广播 消息 的 BroadcastReceiver 之 后 ,就 可 以 完 
成 在 AndroidManifest. xml 配置 文件 中 的 静态 注册 。 

在 AndroidManifest. xml 文件 的 二 application 二 元 素 下 ,声明 TestBroadcastActivity 
和 MyReceiver。 在 MyReceiver 的 二 intentrfilter 二 中 设 定 com. android. broadcast 
.RECEIVER_ACTION 为 符合 接收 条 件 action 字段 的 值 , 见 代 码 5. 14。 

代码 5.14 AndroidManifest. xml 配置 文件 
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执行 应 用 程序 , 单 击 用 户主 界面 图 5. 1 的 按钮 ,程序 会 调用 MyReceiver 中 的 
onReceive() 方 法 ,LogCat 输出 信息 如 图 5. 2 所 示 。 


Tine pid tag Hessage 
09-01 13:17 I 863 Test MyReceiver onReceive—— 


图 5.2 LogCat 输出 信息 
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BroadcastReceiver 采用 在 Java 程序 代码 中 调用 Activity 的 方法 来 注册 。 为 是 在 
程序 运行 过 程 中 才 注 册 , 所 以 称 为 动态 注册 。 注 册 时 ,所 需要 信息 同样 包括 receiver 和 
IntentFilter, 以 及 action 的 条 件 。 

动态 注册 方式 与 静态 注册 方式 不 同 , 因 为 在 程序 运行 中 注册 ,所 以 当 应 用 程序 关闭 
后 ,receiver 就 不 再 进行 监听 。 

下 面 这 个 例子 通过 按钮 事件 ,在 Java 程序 中 Re er 
动态 实现 BroadcastReceiver 的 注册 和 注销 , 见 ET 
图 5.3。 

要 实现 这 个 例子 的 功能 ,需要 作 下 面 一 些 
工作 : 

(1) 定义 具有 三 个 按钮 的 用 户 界面 的 布局 文 
件 main. xml, 和 相关 的 资源 文件 ,代码 略 。 

(2) 定义 用 户 界 面 的 Activity, 导 入 布局 文件 ,并 根据 按钮 不 同 的 功能 ,在 按钮 单 击 事 
件 处 理 代码 中 实现 不 同 的 功能 , 见 代 码 5. 15。 

(3) 定义 BroadcastReceiver, 处 理 广播 消息 , 见 代码 5. 16。 

(4) 在 AndroidManifest. xml 中 注册 所 定义 的 Activity 和 BroadcastReceiver。 

代码 5.15 TestDynamicRecieverActivity. java 


图 5.3 动态 实现 BroadcastReceiver 
的 注册 和 注销 界面 


import android.app.Activity; 
import android.oontent.. Intent; 

import android.os.Bundle; 

import android.view.View.OnClickListener; 


public class TestDynamicRecievernctivity extends Activity{ 
// 定 义 action 常 量 
protected static final String ACTION= "oom.android.broadcast. .RECEIVER ACTICN"; 
private Button btnBroadcast; 
private Button registerReceiver; 
private Button unregisterReceiver; 


~® 
Dd 
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代码 5.16 MyReceiver. java 
jimport androiq.content.BroadcastReceiver7 


public class MyReceiver extends BroadcastReceiverf 
// 定 义 日 志 标签 
private static final String TAG= "Test"; 
@ Override 
Public void onReceive (Context oontext, Intent intent){ 
// 输 出 日 志 信息 
Iog.i(TRG，"MyYReceiver onReceive- ——>"); 


1 


Java 程序 代码 编写 完成 后 ,不 要 忘记 还 需要 在 AndroidMenifest. xml 文件 中 注册 才 
能 够 运行 。 执 行 前 面 的 代码 ,出 现 用 户 界面 后 ,可 以 分 步 测试 ,观察 结果 日 志 , 了 解 动态 注 
册 对 接收 器 功能 的 影响 。 

(1) 单 击 “ 发 送 广播 ”按钮 的 时 候 , 因为 程序 没有 注册 BraodcastReceiver, 所 以 
MyReceiver 不 会 监听 处 理 任何 广播 信息 ,LogCat 没有 输出 任何 信息 。 

(2) 单 击 “注册 广播 接收 器 ”按钮 ,程序 会 执行 此 按钮 事件 处 理 代 码 , 动 态 地 注册 
BraodcastReceiver; 再 单 击 * 发 送 广播 按钮 ,MyReceiver 会 监听 系统 中 的 广播 Intent, 并 
检测 是 否 与 注册 的 过 滤 条 件 匹 配 ,这 里 发 出 的 Intent 的 Action 字段 的 值 与 动态 注册 的 
intentFilter 条 件 相 同 ,系统 会 调用 其 onReceive() 方 法 处 理 这 个 广播 消息 , 则 LogCat 会 
增添 新 的 日 志 信 息 。 

(3) 单 击 * 注 销 广 播 监 听 器 ”按钮 ,程序 会 执行 此 按钮 事件 处 理 代码 ,动态 地 注销 
BraodcastReceiver, MyReceiver 恢复 到 没有 注册 时 的 情况 ;再 单 击 “ 发 送 广 播 ” 按 钮 ， 
LogCat 没有 输出 任何 信息 。 


5.3 Notification 管理 


Notification, 即 “通知 ?是 一 个 消息 ,可 以 在 应 用 程序 界面 显示 其 图 形 标记 ,提示 用 
户 。 例 如 当 用 户 操作 应 用 时 ,如 果 有 电话 、 短 信 或 者 邮件 到 达 , 可 以 向 系统 提交 一 个 
Notification , 它 会 首先 以 图 标的 形式 显示 在 设备 的 状态 栏 位 置 , 在 手机 的 状态 栏 上 就 会 
出 现 一 个 小 图 标 ,提示 用 户 处 理 这 个 消息 ,如 图 5.4 所 示 。 用 户 手 从 上 方 滑动 状态 栏 就 可 
以 展开 查看 通知 的 详细 信息 ,并 进行 处 理 。 

通知 的 详细 信息 展开 后 的 显示 元 素 如 图 5. 5 所 示 。 
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5.4 ”Notification 显示 图 标 图 5.5 Notification 的 显示 元 素 


对 应 图 中 的 标号 ,元 素 分 别 为 : 
: 通知 的 标题 。 

: 大 图 标 。 

: 通知 的 内 容 。 

: 通知 的 信息 。 

: 小 图 标 。 

: 通知 发 出 的 时 间 。 

Android 提供 了 两 种 类 型 的 Notification 视图 : 正常 视图 (Normal view) 和 大 视图 
(Big view) ,图 5.5 是 正常 的 视图 ,还 有 一 种 是 大 视图 ,除了 正常 视图 的 元 素 之 外 ,还 包括 
消息 的 细节 内 容 。 消 息 细节 内 容 的 图 形 显示 样式 可 以 设置 为 不 同 的 样式 ,包括 大 图 样式 、 
大 文本 样式 、 收 件 箱 样式 等 。 这 些 样式 上 还 包括 一 些 正 常 视图 上 没有 的 界面 元 素 。 


中 mn oo 


531 创建 Notification 


Notification 与 Toast 都 可 以 起 到 通知 ,提醒 的 作用 ,都 可 以 随时 取消 。 但 它们 的 实 
现 原理 和 表现 形式 却 完全 不 一 样 。Toast 相当 于 一 个 定时 关闭 的 对 话 框 ,是 用 户 界面 某 
个 Activity 的 一 部 分 ,也 可 以 用 弹出 的 方式 对 用 户 的 某 个 操作 给 出 简单 的 反馈 。 
Notification 显示 在 屏幕 上 方 状 态 栏 中 ,在 用 户 界面 之 外 ,也 可 以 有 闪烁 .声音 、 震 动 等 其 
他 的 形式 ,是 相对 独立 的 。 更 重要 的 是 ,使 用 和 查看 Notification 通常 会 对 系统 的 任务 栈 
产生 影响 ,需要 用 NotificationManager 来 管理 ,而 对 于 Toast, 只 需要 简单 地 创建 对 象 并 
显示 ,不 会 对 系统 产生 影响 。 

Android 系统 的 NotificationCompat. Builder 类 用 于 创建 Notification 对 象 。 在 应 用 
需要 时 ,可 以 使 用 Notification. Builder. build() 方 法 来 创建 一 个 Notification 对 象 ,并 同时 
设置 其 界面 显示 图 标 和 动作 。 

NotificationManager 类 用 于 管理 Notification 对 象 。 使 用 NotificationManager. notify() 
可 以 将 创建 后 的 Notification 对 象 向 系统 发 布 出 去 ,在 状态 栏 中 显示 出 来 。 

在 一 个 Notification 对 象 中 ,有 三 个 字段 是 必须 赋值 的 : 

。 小 图 标 。 


”标题 。 
。 文本 内 容 。 


在 创建 Notification 对 象 时 ,可 以 由 Notification. Builder. build() 方 法 直接 给 这 三 个 
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字段 赋值 ,也 可 以 在 创建 完成 后 ,使 用 setSmalllcon() 方 法 、setContentTitle() 方 法 和 
setContentText() 方 法 分 别 进行 设置 。 其 他 的 字段 都 是 可 选 的 。 具 体 字段 的 细节 ,可 以 
查阅 Notification. Builder 类 的 说 明 。 

虽说 其 他 字段 都 是 可 选 的 ,但 一 般 来 说 ,每 个 Notification 至 少 还 是 会 设置 一 个 动作 
action。 例 如 用 户 在 单 击 或 触发 Notification 的 时 候 ,可 以 打开 一 个 Activity ,或 者 关闭 闹 
钟 ,或 者 打开 一 个 浏览 器 等 。 一 个 Notification 可 以 定义 多 个 动作 ,在 其 被 单 击 时 同时 
触发 。 

Notification 对 象 中 所 设 定 的 动作 ,是 通过 PendingIntent 对 象 来 定义 的 。PendingIntent 
对 象 中 包含 一 个 Intent, 可 以 用 来 启动 一 个 Activity。 通 过 Notification. Builder 中 的 
setContentIntent() 方 法 来 将 一 个 PendingIntent 对 象 与 一 种 操作 关联 起 来 。 

创建 和 发 布 一 个 简单 的 Notification 分 下 面 几 个 步骤 。 

(1) 创建 一 个 Notification Builder。 

在 创建 一 个 Notification 对 象 时 ,需要 通过 Notification. Builder 定义 Notification 定 
义 它 的 小 图 标 、 标 题 和 文本 内 容 , 代 码 如 下 : 


本 
new NbtificationCorpat.Builder(this) 
.setSmallIcon (R.drawable.notification icon) 
.setContentTitle ("My notification") 
.setContentText ("Hello World!") ; 


(2) 定义 Notification 的 Action 动作 。 

一 般 来 说 ,每 个 Notification 至 少 还 是 会 设置 一 个 动作 Action, 通 过 这 个 Action 启动 
其 他 的 Activity, 让 用 户 进 入 应 用 程序 的 另 一 个 用 户 界面 ,查看 引起 这 个 Notification 的 
事件 或 作 进 一 步 处理 。 

Notification 的 动作 定义 通 PendingIntent 对 象 完 成 。 具 体 代 码 实 现时 首先 创建 一 个 
Intent 对 象 , 设 置 在 Notification 操作 时 要 启动 的 Activity; 然 后 创建 一 个 这 个 Intent 对 
象 的 PendingIntent 对 象 ,具体 如 何 构建 PendingIntent 对 象 与 启动 的 Activity 类 型 有 关 。 

下 面 是 简单 的 代码 : 


Intent resultIntent= new Intent (this, ResultActivity.class); 


PendingIntent resultPendingIntent— 
PendingIntent .getActivity( 
this, 

0, 
resultIntent, 


基于 Anrdroid 平 台 的 移动 互联 网 开发 


(3) 设置 Notification 的 单 击 行为 。 

如 果 要 把 上 面 定 义 的 PendingIntent 对 象 与 一 个 用 户 操 作 相 关联 ,需要 调用 
NotificationCompat. Builder 的 对 应 方法 。 例 如 , 当 用 户 单 击 通知 Notification 的 文本 时 ， 
要 启动 一 个 Activity, 则 通过 setContentIntent() 方 法 添加 前 面 定义 的 PendingIntent 对 
象 ,代码 如 下 。 


Bui lder.setContentIntent (resultPendingIntent); 


简单 地 说 ,PendingIntent 就 是 在 Intent 上 加 了 指定 的 动作 。 对 于 Intent 来 说 ,只 有 
在 执行 startActivity() ,startService() 或 sendBroadcast() 方 法 后 ,才能 使 Intent 有 用 ;而 
对 于 PendingIntent 来 说 , 本身 就 包含 了 这 些 方法 的 功能 ,还 可 以 使 用 PendingIntent 
.getActivity() 和 PendingIntent, getService() 方 法 来 调用 Activity 和 Service。 例 如 : 


PendingIntent pi= PendingIntent .getActivity (this, 0, new Intent (this, 
HandleNotificationnctivity.class), 0) 


PendingIntent 还 有 PendingIntent. getBroadcast() 方 法 ,其 包含 了 sendBroadcast() 
的 功能 。 

(4) 发 布 一 个 Notification 。 

发 布 Notification 时 ,首先 要 获取 一 个 Notification 实例 ,使 用 notify() 方 法 发 布 
Notification 对 象 ,然后 使 用 build() 返 回 一 个 Notification 对 象 。 


//Sets an ID for the notificaticn 

int nNotificationId= 0017 

//Gets an instance of the NotificationManager service 
(NotificationManager) getSystemService (NOTIFICATION SERVICE); 

//Builds the notification and issues 让 

TKNDtifyMgr.notify (NotificationId, rmBuilder.build()); 


到 此 为 止 , 创 建 一 个 简单 的 Notification 的 代码 就 完成 了 。 

下 面 通过 一 个 简单 的 例子 ,说 明 如 何在 应 用 程序 中 创建 和 使 用 Notification。 在 这 个 
例子 中 , 主 界面 是 一 个 Button, 单 击 Button 后 创建 一 个 简单 的 Notification, 这 个 
Notification 的 具体 内 容 由 另 一 个 Activity 显示 。 

首先 ,在 SampleofAndroid 项 目 中 定义 主 界面 的 布局 文件 ,说 明 主 界面 中 的 Button 
单 击 后 的 事件 处 理 代 码 由 createNotification() 方 法 实现 , 见 代 码 5. 17。 

代码 5.17 simple_notif_layout. xml 


< Zuml version= "1 .0" encoding= "utf 8"2> 

< LinearTayout xmlns:android= "http://schemas.android.om/apk/res/android" 
android:layout widthr "atch Parent" 
android:layout height= "match parent" 
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然后 ,定义 查看 Notification 内 容 界 面 的 布局 文件 , 见 代码 5. 18。 
代码 5.18 simple_notif_result_layout. xml 


创建 展示 Notification 内 容 的 Activity, 见 代码 5. 19。 
代码 5.19 NotificationResultActivity. java 


创建 主 界面 的 Activity, 在 其 中 实现 Button 单 击 事件 处 理 器 createNotification() 方 
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法 ,在 其 中 创建 Notification, 见 代码 5. 20。 
代码 5.20 CreateNotificationActivity. java 


上 面 的 Notification 的 例子 是 最 简单 的 Notification 格式 ,如 果 要 向 通知 添加 声音 、 闪 
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灯 和 振动 效果 ,最 简单 .最 一 致 的 方式 是 使 用 当前 的 用 户 默认 设置 ,使 用 Notification 的 
defaults 属性 。 这 些 属性 可 以 组 合 使 用 。 例 如 : 


如 果 想 全 部 使 用 默认 值 ,可 以 使 用 Notification. DEFAULT_ALL 常量 。 


通过 向 sound 属性 分 配 一 个 位 置 URI,android 可 以 将 手机 上 的 任意 音频 文件 作为 通 
知 进行 播放 。 

下 面 给 出 一 些 Notification 提示 方式 的 不 同 设置 的 例子 。 

(1) 在 状态 栏 (Status Bar) 显 示 的 通知 文本 提示 : 


(2) 发 出 提示 音 : 


(3) 手机 振动 : 


(4) LED 灯 闪 烁 : 


或 者 可 以 用 自己 的 LED 提醒 模式 : 


532 导航 设计 


应 用 程序 创建 完 Notification 后 , Notification 会 在 某 个 条 件 满足 时 被 发 布 ,这 时 在 用 
户 界面 上 方 的 状态 栏 中 会 出 现 一 个 图 标 。 例 如 ,用 户 在 玩 游戏 的 时 候 收 到 了 一 封 E-mail， 
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邮件 到 达 的 Notification 就 会 显示 在 状态 栏 中 。 用 户 可 以 在 任何 时 候 滑 动 图 标 打开 
Notification 查看 其 内 容 。 

当 用 户 从 某 个 应 用 程序 界面 去 查看 一 个 Notification 时 ,需要 离开 当前 的 Activity， 
离开 当前 的 应 用 程序 流程 ,由 Notification 的 PendingIntent 去 启动 男 一 个 Activity ,来 展 
示 Notification 的 内 容 。 这 个 Activity 可 能 是 另 一 个 应 用 程序 正常 流程 中 的 一 个 界面 ,也 
可 能 仅仅 是 一 个 独立 的 显示 界面 。 如 果 不 作 任 何 设置 , 当 用 户 浏览 完 Notification 按 
Back 回 退 键 时 ,无论 前 面 的 哪 种 情况 ,用户 界面 会 回 到 查看 Notification 之 前 的 界面 。 如 
果 和 希望 针对 这 两 种 情况 作 不 同 的 处 理 , 在 设计 Notification 时 可 以 根据 情况 采用 不 同 的 
Activity 启动 方式 。 

Notification 有 两 种 常用 的 Activity 启动 方式 : 有 规律 的 Activity 和 特定 的 
Activity。 

(1) 有 规律 的 Activity。 

如 果 Notification 启动 的 Activity 是 一 个 应 用 程序 正常 流程 的 一 部 分 , 则 这 个 需 启动 
的 Activity 归 为 有 规律 的 Activity。 在 这 种 情况 下 ,可 以 创建 一 个 PendingIntent 来 启动 
一 个 新 任务 , 即 启动 一 个 新 的 应 用 程序 ,并 且 给 PendingIntent 建立 一 个 回 退 栈 , 这 个 回 退 
栈 中 复制 了 这 个 程序 流程 中 按 Back 回 退 键 程序 作出 的 正常 反应 行为 。 

例如 ,Gmail 邮件 的 Notification 示范 了 这 类 固定 的 Activity, 当 用 户 触 点 一 个 邮件 的 
Notification 时 ,用 户 可 以 看 到 这 个 信息 ;而 使 用 Back 键 后 ,用 户 会 回 到 Gmail 收 件 箱 的 
Activiy。 如 果 用 户 继续 使 用 Back 键 , 则 回 到 Home 界面 上 ,这 就 像 从 Home 界面 进入 
Gmail 应 用 效果 一 样 。 

这 种 情况 的 设置 ,通过 Notification 进入 一 个 应 用 程序 后 ,会 按照 这 个 应 用 程序 的 流 
程 正常 运行 ,与 用 户 直接 运行 这 个 应 用 程序 功能 相同 。 如 果 用 户 持 续 按 Back 键 或 直接 按 
Home 键 ,最 后 会 回 到 Home 界面 上 ,而 不 是 最 初 查看 Notification 的 应 用 程序 界面 。 

(2) 特定 的 Activity。 

如 果 从 Notification 启动 的 Activity 并 不 是 某 个 应 用 程序 流程 的 一 部 分 ,为 了 显示 
Notification 很 难 显 示 的 信息 或 更 细节 信息 而 创建 的 用 户 界面 ,是 Notification 的 一 个 扩 
展 , 则 将 这 个 Activity 定义 为 特定 的 Activity。 这 种 情况 下 ,不 需要 创建 回 退 栈 ,如 果 使 
用 Back 键 ,会 直接 回 到 Home 界面 。 

1. 为 有 规律 的 Activity 创建 PendingIntent 

第 一 步 , 在 Manifest 文件 中 定义 应 用 程序 的 Activity 层次 结构 。 

对 于 Android 4. 0. 3 和 之 前 的 版 本 ,通过 在 二 activity 二 元 素 中 增加 二 meta-data 二 子 
元 素来 指定 Activity 的 父 级 。 在 这 个 子 元 素 中 ,设置 android:name 一 "android. support 
.PARENT_ACTIVITY" 和 android: value 王 "一 parent_activity_name 二 " ,其 中 一 parent_ 
activity_name 二 是 指 父 生 activity 二 元 素 的 名 称 。 

对 于 Android 4. 1 和 之 后 的 版 本 ,通过 为 二 activity 过 元素 增 加 android: parent- 
ActivityName 属 性 来 设置 , 见 代码 5. 21 。 
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代码 5.21 Manifest 中 定义 Activity 层次 结构 


第 二 步 , 基 于 启动 Activity 的 Intent 创建 回 退 栈 。 创 建 回 退 栈 需 要 完成 下 面 几 个 
设置 。 

(1) 创建 启动 Activity 的 Intent。 

(2) 调用 TaskStackBuilder. create() 创 建 栈 创建 器 。 

(3) 调用 addParentStack() 把 回 退 栈 加 入 栈 中 ,对 于 定义 在 menifest 层次 中 的 每 一 
个 Activity, 回 退 栈 中 都 包含 一 个 启动 它 的 Intent 对 象 。 

(4) 调用 addNextIntent() 添 加 从 Notification 中 启动 Activity 的 Intent ,把 前 面 所 创 
建 的 Intent 作为 参数 。 

(5) 如 果 需 要 给 栈 中 的 Intent 对 象 添加 参数 , 可 以 调用 TaskStackBuilder. 
editIntentAt() ,这 可 以 保证 让 用 户 在 使 用 Back 键 导航 时 .确保 目标 Activity 显示 有 效 的 
数据 。 

(6) 调用 getPendingIntent() 方 法 从 回 退 栈 中 获取 一 个 PendingIntent, 然 后 把 这 个 
PendingIntent 作为 setContentIntent() 方 法 的 参数 。 

具体 的 设置 过 程 可 以 参考 代码 5. 22。 

代码 5.22 创建 回 退 栈 
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PendingIntent resultPendingIntent— 
stackBui lder .getPendingIntent (0, PendingIntent.FIAGS UPDATE CURRENT); 


NtificationCompat-Builder builder= new NptificationCompat-Builder(this); 
builger. setContentIntent (resultPendingIntent); 
Notificati ornManager mNotificati orManager=— 

(NbtificaticrMenager) getSysterService (Cntest.NOTIFTCATTION SERVICE); 
NotificationManager.notify(id, builgder.build()); 


2. 使 用 特定 的 Activity 

如 果 使 用 特定 的 Activity, 就 不 需要 使 用 回 退 栈 , 也 不 需要 在 Manifest 中 定义 
Activity 的 层次 结构 等 ,而 是 需要 设置 Activity 的 任务 选项 ,并 且 使 用 getActivity() 方 法 
创建 PendingIntent。 

第 一 步 , 在 manifest 文件 中 添加 android: taskAffinity 和 android: excludeFromRecents 
这 两 个 一 activity 过 属性 的 设置 , 见 代码 5. 23。 

代码 5.23 manifest 说 明 特 定 的 Activity 属性 


<activity 
android:name= ".ResultActivity" 


android:launchMpde= "singleTask" 

android:taskAffinity="" 

android:excludeFramReoents= "true"> 
< /activity> 


第 二 步 ,建立 和 发 布 Notification, 见 代码 5. 24。 

(1) 创建 启动 Activity 的 Intent。 

(2) 通过 调用 setFlags() 设 置 新 的 空 任务 ,把 FLAG_ACTIVITY_NEW_TASK 和 
FLAG_ACTIVITY_CLEAR_TASK 作为 标记 参数 。 

(3) 设置 Intent 的 其 他 需要 的 选项 。 

(4) 通过 调用 getActivity() 方 法 使 用 Intent 创建 一 个 PendingIntent 对 象 ,然后 把 这 
个 PendingIntent 作为 setContentIntent() 方 法 的 参数 。 

代码 5.24 建立 和 发 布 Notification 


//Instantiate a Builder cbject 
NbtificationCompat.Builder builder= new NotificationCompat..Builger (this); 
//Creates an Intent for the Bctivity 
Intent notifyIntent— 

new Intent (new CamponentName (this, ResultActivity.class)); 
//Sets the Rctivity to start in a new, epty task 
notifyIntent .setFlags (FIAG PACTIVITY NEW TASK|FIAG ACTIVITY CIFAR TASK); 
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//Puts the PendingIntent into the notification builder 
builder.setContentIntent (notifyIntent); 
//Notifications are issued by sending them to the 
//NotificationManager system servioe. 
(NotificationManager) getSystemService (Context.NOTIFICATION SERVICE); 
//Builds an anonymous Notification cbject fram the builder，and 
//passes 让 to the NotificationManager 
mNotificationManager.notify (id, builder.build()); 


Notification 通过 有 规律 的 Activity 启动 方式 和 特定 的 Activity 启动 方式 ,都 可 以 使 
用 户 在 查看 Notification 之 后 ,通过 Back 键 和 Home 键 回 到 Home 界面 。 如 果 创 建 
Notification 时 不 做 任何 设置 , 则 Back 键 会 使 用 户 界面 回 到 查看 Notification 之 前 的 
界面 。 
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Android 4.1 对 Android 的 Notification 框架 进行 了 重大 的 更 新 。 应 用 程序 现在 可 以 
通过 点 选 展开 或 者 折 生 来 显示 更 大 、 更 丰富 的 Notification。Notification 支持 包括 照片 
在 内 的 新 内 容 类 型 ,支持 优先 级 的 配置 ,以 及 多 个 动作 的 设置 。 使 用 改进 Notification ,应 
用 程序 可 以 创建 的 使 用 面积 较 大 ,高 达 256 DP 的 高 度 的 Notification 信息 。 

Android 系统 提供 的 Notification 主要 包括 以 下 4 种 类 型 。 

(1) 基本 类 型 ,其 使 用 图 标 显示 简短 的 通知 信息 。 

(2) 大 图 片 类 型 (Big picture style) , 它 可 以 显示 图 片 的 内 容 , 例 如 位 图 。 

(3) 大 文本 类 型 (Big text style) , 它 可 以 显示 多 个 TextView。 

(4) 收 件 箱 类 型 (Inbox style) , 它 可 以 显示 任何 类 型 的 列表 。 

前 面 的 例子 都 是 创建 的 基本 类 型 的 Notification。 基 本 类 型 Notification 呈现 的 是 正 
常 视图 (Normal view) ,而 后 面 3 种 类 型 的 Notification 都 属于 大 视图 (Big view) 模 式 。 
下 面 来 简单 介绍 大 视图 模式 的 Notification 如 何 创 建 。 

在 Android 4. 1 之 前 的 版 本 中 ,需要 程序 员 直 接 创建 Notification 对 象 ,而 Android 
4.1 之 后 的 版 本 可 以 使 用 Notification. Builder 类 来 创建 Notification 对 象 , 简化 了 
Notification 对 象 创建 的 过 程 ,而 且 可 以 根据 需求 ,使 用 Notification. BigPictureStyle、 
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Notification. BigTextStyle 和 Notification. InboxStyle 工具 类 ,创建 各 种 类 型 的 通知 。 下 
面 是 如 何 创建 大 视图 模式 Notification 的 3 种 样式 的 代码 示范 。 
(1) 多 文本 类 型 。 


(2) 大 图 类 型 。 


(3) 收 件 箱 类 型 。 
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-addncticon (R.drawable.ic launcher web, "show activity", pi); 


Notification notification= new Notification.InboxStyle (builder) 
.addLine ("First message") .addLine ("Seoond message") 
.addLine ("Thrid message") .addLine ("Fourth Message") 
.3etSunmaryText ("+ 2 mpre") .build(); 

//Put the auto cancel notification flag 

notification.flags |=Notification.FIAG AUTO CANCEL; 


在 设置 Notification 的 样式 完成 后 ,创建 Notification 的 其 余 步骤 与 基本 样式 类 似 。 
5.4 小 结 


本 章 主要 介绍 了 Android 系统 中 用 于 消息 传递 的 组 件 Intent、BroadcastReciever 和 
Notification 。 

Intent 是 Android 的 一 个 基础 组 件 。 通 过 Intent 的 消息 创建 、 消 息 触 发 .消息 传递 和 
消息 响应 ,Android 系统 实现 窗口 跳 转 、 传 递 数 据 或 调用 外 部 程序 ,进行 应 用 程序 的 激活 
和 调用 。Android 的 三 大 基础 组 件 Activity Service BroadcastReceiver, 都 可 以 通过 定义 
Intent 的 消息 ,实现 在 各 组 件 之 间 的 程序 跳 转 和 数据 传递 。Intent 对 象 中 同时 携带 触发 
其 他 组 件 执行 的 条 件 信 息 和 触发 后 该 组 件 执行 时 所 需要 的 信息 。 

使 用 Intent 来 实现 程序 跳 转 和 数据 传递 有 两 种 不 同方 式 : 显 式 和 隐 式 。 在 Intent 对 
象 的 组 件 名 称 属性 ComponentName 里 直接 设 定 要 激活 的 组 件 ,这 种 方式 称 为 显 式 ; 
Activity、Service、BroadcastReceiver 可 以 在 menifest 文件 中 ,通过 Intent 过 滤器 设置 一 
个 或 多 个 条 件 , 说 明 该 组 件 可 接收 的 Intent 对 象 . 过 滤 掉 不 想 接收 的 隐 式 Intent 对 象 ,这 
种 方式 称 为 隐 式 。 

BroadcastReceiver 是 Android 系统 中 负责 接收 广播 消息 并 对 消息 做 出 反应 的 组 件 。 
BroadcastReceiver 没 有 用 户 界面 ,可 以 接收 到 信息 后 启动 activity 或 者 通过 
NotificationManger 通知 用 户 ,也 可 以 通过 其 他 多 种 方式 通知 用 户 。 多 数 的 广播 是 系统 
发 起 ,如 果 是 用 户 应 用 程序 发 送 广播 消息 ,在 Intent 对 象 创建 后 ,启动 BroadcastRecevicer 
的 方式 有 两 种 : sendBroadcast() 方 法 和 sendOrderedBroadcast() 方 法 。 

Notification 通知 是 一 个 消息 ,以 图 标的 形式 显示 在 设备 的 状态 栏 位 置 ,提示 用 户 。 
Android 提供 了 两 种 类 型 的 Notification 视图 : 正常 视图 (Normal view) 和 大 视图 (Big 
view)。Android 系统 的 NotificationCompat. Builder 类 用 于 创建 Notification 对 象 。 在 
应 用 需要 时 ,可 以 使 用 Notification. Builder. build() 方 法 来 创建 一 个 Notification 对 象 ,并 
同时 设置 其 界面 显示 图 标 和 动作 。 
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6.1 基本 概念 


在 Android 系统 中 ,如 果 有 一 个 应 用 程序 组 件 是 第 一 次 被 启动 ,而且 这 时 应 用 程序 也 
没有 其 他 组 件 在 运行 , 则 Android 系统 会 为 应 用 程序 创建 一 个 Linux 进程 ,这 个 Linux 进 
程 只 包含 一 个 线程 。 举 个 例子 ,如 果 一 个 应 用 程序 启动 了 第 一 个 Activity, 这 个 Activity 
里 有 一 个 文本 框 和 一 个 按钮 ,这 时 ,Android 系统 会 为 应 用 程序 创建 一 个 单个 线程 的 
Linux 进程 ,初始 化 这 个 文本 框 和 按钮 , 当 这 个 应 用 程序 启动 另 一 个 Activity 时 ,初始 化 
图 形 组 件 的 还 是 这 个 已 经 创建 好 的 线程 ,不 会 再 创建 新 的 。 也 就 是 说 ,这 个 应 用 程序 会 一 
直 单 线程 单 任务 地 运行 图 形 组 件 的 初始 化 和 与 图 形 组 件 相关 的 操作 。 

默认 情况 下 ,同一 个 应 用 程序 的 所 有 组 件 都 运行 在 同一 个 进程 和 线程 里 ,这 个 线程 叫 
做 “主线 程 "。 如 果 一 个 组 件 启动 时 ,应 用 程序 的 其 他 组 件 已 经 在 运行 , 则 此 组 件 会 在 已 有 
的 进程 和 线程 中 启动 运行 。 

如 果 和 希望 Android 应 用 程序 实现 多 任务 ,可 以 通过 代码 指定 组 件 运行 在 其 他 进程 里 ， 
或 为 进程 创建 额外 的 线程 。 

接 下 来 看 看 Android 的 进程 调度 机 制 。 
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默认 情况 下 ,同一 个 应 用 程序 内 的 所 有 组 件 都 是 运行 在 同一 个 进程 中 的 ,大 部 分 应 用 
程序 都 是 按照 这 种 方式 运行 的 。 

但 在 具体 应 用 中 ,很 多 时 候 需 要 通过 在 manifest 文件 中 进行 设置 ,指定 某 个 特定 组 
件 归属 于 哪个 进程 。 

可 以 通过 AndroidManifest. xml 文件 设 定 应 用 程序 归属 的 进程 。manifest 文件 中 的 
每 种 组 件 元 素 一 一 一 activity 二 、 二 service 二 、 一 receiver 二 和 志 provider 二 都 支持 定义 
android:process 属性 ,用 于 指定 组 件 运行 的 进程 。 

设置 这 个 属性 就 可 实现 每 个 组 件 在 各 自 的 进程 中 运行 ,或 者 某 几 个 组 件 共享 一 个 进 
程 而 其 他 组 件 运行 于 独立 的 进程 。 设 置 这 个 属性 也 可 以 让 不 同 应 用 程序 的 组 件 运行 在 同 
一 个 进程 中 ,这 就 实现 了 多 个 应 用 程序 共享 同一 个 Linux 用 户 ID ,赋予 同样 的 权限 。 

一 application 二 元 素 也 支持 android:process 属性 ,用 于 指定 所 有 组 件 的 默认 进程 。 

Android 一 个 重要 并 且 特 殊 的 特性 就 是 ,一 个 应 用 的 进程 的 生命 周期 不 是 由 应 用 程 
序 自身 直接 控制 的 ,而 是 由 系统 根据 运行 中 应 用 的 一 些 特征 来 决定 的 ,包括 这 些 应 用 程序 
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对 用 户 的 重要 性 、 系 统 的 全 部 可 用 内 存 。 

大 部 分 情况 下 ,每 个 Android 应 用 程序 都 将 运行 在 自己 的 Linux 进程 中 。 当 这 个 应 
用 的 某 些 代 码 需 要 执行 时 ,进程 就 会 被 创建 ,并 且 将 保持 运行 ,直到 该 进程 不 再 需要 ,而 系 
统 需要 释放 它 所 占用 的 内 存 ,为 其 他 应 用 所 用 时 才 停 止 。 

Android 系统 试图 尽 可 能 长 时 间 地 保持 应 用 程序 进程 ,但 为 了 新 建 或 者 运行 更 加 重 
要 的 进程 ,总 是 需要 清除 过 时 进程 来 回收 内 存 。 为 了 决定 保留 或 终止 哪个 进程 ,根据 进程 
内 运行 的 组 件 及 这 些 组 件 的 状态 ,系统 把 每 个 进程 都 划 入 一 个 “重要 性 层次 结构 "中 。 重 
要 性 最 低 的 进程 首先 会 被 清除 ,然后 是 下 一 个 最 低 的 , 依 此 类 推 ,这 都 是 回收 系统 资源 所 
必需 的 。 

重要 性 层次 结构 共有 5 个 级 ,以 下 列表 按照 重要 程度 列 出 了 各 类 进程 ,其 中 第 一 类 进 
程 是 最 重要 的 ,将 最 后 一 个 被 终止 。 

。 前 台 进 程 。 

。 可 见 进程 。 

。 服务 进程 。 

。 后 台 进 程 。 

。 空 进程 。 

1. 前 台 进程 

前 台 进 程 是 用 户 当 前 操作 所 必需 的 进程 。 满 足以 下 任 一 条 件 时 ,进程 被 视 作 处 于 前 台 : 

。 正在 与 用 户 交互 的 Activity 进程 ,例如 Activity 的 onResume() 方 法 已 被 调用 。 

。 正在 与 用 户 交互 的 Activity 绑 定 的 Service 进程 。 

。 正在 运行 前 台 Service 进程 ,例如 Service 被 startForeground() 方 法 调用 。 

。 正在 运行 生命 周期 回调 方法 (例如 onCreate()、onStart() 或 onDestroy()) 的 

Service。 

。 正在 运行 onReceive() 方 法 的 BroadcastReceiver。 

一 般 而 言 ,任何 时 刻 只 有 很 少 的 前 台 进 程 同 时 运行 。 只 有 当 内 存 不 足以 维持 它们 同 
时 运行 时 ,作为 最 后 的 策略 它们 才 会 被 终止 。 通 常 ,终止 一 些 前 台 进 程 是 为 了 保证 用 户 界 
面 的 及 时 响应 。 

2. 可 见 进程 

如 果 进 程 没 有 任何 前 台 组 件 ,但 仍 会 影响 用 户 在 屏幕 上 所 见 内 容 的 进程 , 称 为 可 见 进 
程 。 满 足以 下 任 一 条 件 时 ,进程 被 认为 是 可 见 的 : 

如 果 Activity 不 在 前 台 , 但 用 户 仍 然 可 见 ( 例 如 Activity 的 onPause() 方 法 被 调用 
了 )。 例 如 当前 台 Activity 打开 了 一 个 对 话 框 .而 之 前 的 Activity 还 允许 显示 在 后 面 , 但 
是 已 经 无 法 与 用 户 进行 交互 。 

一 个 绑 定 到 可 见 或 前 台 Activity 的 Service 进程 。 

可 见 进 程 被 认为 是 非常 重要 的 进程 ,除非 无 法 维持 所 有 前 台 进程 同时 运行 ,它们 是 不 
会 被 终止 的 。 

3. 服务 进程 

对 于 由 startService() 方 法 启动 的 Service 进程 , 它 不 会 升级 为 上 述 两 种 级 别 。 尽 管 
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服务 进程 不 直接 和 用 户 所 见 内 容 关联 ,但 它们 通常 在 执行 一 些 用 户 关心 的 操作 ,例如 在 后 
台 播 放 音 乐 或 从 网 络 下 载 数据 等 。 因 此 ,除非 内 存 不 足以 维持 所 有 前 台 、 可 见 进程 同时 运 
行 ,系统 会 保持 服务 进程 的 运行 。 

4. 后 台 进 程 

后 台 进 程 指 包含 目前 用 户 不 可 见 Activity( 例 如 Activity 的 onStop() 方 法 已 被 调用 ) 
的 进程 。 这 些 进 程 对 用 户 体验 没有 直接 的 影响 ,系统 可 能 在 任意 时 间 终 止 它们 ,以 回收 内 
存 供 前 台 进 程 、 可 见 进程 及 服务 进程 使 用 。 通 常会 有 很 多 后 台 进 程 在 运行 ,所 以 它们 被 保 
存在 一 个 LRU( 最 近 最 少 使 用 ) 列 表 中 ,以 确保 最 近 被 用 户 使 用 的 Activity 最 后 一 个 被 终 
止 。 如 果 一 个 Activity 正确 实现 了 生命 周期 方法 ,并 保存 了 当前 的 状态 , 则 终止 此 类 进程 
不 会 对 用 户 体 验 产 生 可 见 的 影响 。 因 为 在 用 户 返 回 时 ,Activity 会 恢复 所 有 可 见 的 状态 。 
如 果 要 了 解 关于 保存 和 恢复 状态 的 详细 信息 ,可 以 参阅 Activities 生命 周期 文档 。 

5. 空 进程 

空 进程 指 不 包含 任何 活动 应 用 程序 组 件 的 进程 。 保 留 这 种 进程 的 唯一 目的 就 是 用 作 
缓存 ,以 改善 下 一 次 在 此 进程 中 运行 组 件 的 启动 时 间 。 为 了 在 进程 缓存 和 内 核 缓存 间 平 
衡 系统 整体 资源 ,系统 经 常会 终止 这 种 进程 。 

依据 进程 中 目前 活跃 组 件 的 重要 程度 ,Android 会 给 进程 评估 一 个 尽 可 能 高 的 级 别 。 
例如 ,如 果 一 个 进程 中 运行 着 一 个 服务 和 一 个 用 户 可 见 的 Activity, 则 此 进程 会 被 评定 为 
可 见 进程 ,而 不 是 服务 进程 。 

此 外 ,一 个 进程 的 级 别 可 能 会 由 于 其 他 进程 的 依赖 而 被 提高 ,为 其 他 进程 提供 服务 的 
进程 级 别 永远 不 会 低 于 使 用 此 服务 的 进程 。 

因为 运行 服务 的 进程 级 别 是 高 于 后 台 Activity 进程 的 ,所 以 ,如 果 Activity 需要 启动 
一 个 长 时 间 运 行 的 操作 , 则 为 其 启动 一 个 服务 Service 会 比 简单 地 创建 一 个 工作 线程 更 好 
些 一 一 尤其 是 在 此 操作 时 间 比 Activity 本 身 存在 时 间 还 要 长 久 的 情况 下 。 


612 线程 


应 用 程序 启动 时 ,系统 会 为 它 创 建 一 个 名 为 main 的 主线 程 。 主 线程 非常 重要 ,因为 
它 负 责 把 事件 分 发 给 相应 的 用 户 界 面 widget 包括 屏幕 绘图 事件 。 它 也 是 应 用 程序 
与 AndroidUI 组 件 包 ( 来 自 android. widget 和 android. view 包 ) 进 行 交互 的 线程 。 因 此 ， 
主线 程 有 时 也 被 叫做 UI 线程 。 

系统 并 不 会 为 每 个 组 件 的 实例 都 创建 单独 的 线程 。 运行 于 同一 个 进程 中 的 所 有 组 件 
都 是 在 UI 线程 中 实例 化 的 ,对 每 个 组 件 的 系统 调用 也 都 是 由 UI 线程 分 发 的 。 

如 果 应 用 程序 在 与 用 户 交 互 的 同时 需要 执行 繁重 的 任务 ,用 户 单线 程 模式 可 能 会 导 
致 运行 性 能 很 低下 ;比如 说 ,在 查询 数据 库 时 ,应 用 程序 就 需要 做 两 件 事 ,一 是 需要 与 数据 
库 连接 ,访问 数据 库 , 获 取 查 询 结 果 ; 二 是 要 初始 化 显示 界面 的 组 件 ,把 获取 的 数据 给 显示 
出 来 。 因 为 是 单线 程 ,就 必须 先 做 完 第 一 件 事后 才能 做 第 二 件 事 。 这 个 过 程 有 可 能 因为 
网 络 状况 或 数据 库 繁 忙 ,在 访问 数据 库 、 获 取 结 果 数 据 时 花费 比较 长 的 时 间 , 导 致 不 能 执 
行 用 户 显示 界面 的 初始 化 ,使 得 用 户 界 面 呈 现 出 静止 状态 。 这 种 状态 , 称 为 UI 线程 阻 
塞 。 如 果 UI 线程 被 阻塞 超过 一 定时 间 ( 目 前 大 约 是 5 秒 钟 ) ,用 户 就 会 被 提示 “应 用 程序 


第 4 章 ， 多 任务 与 服务 Nd 


没有 响应 ”ANR) 对 话 框 ,如 图 6. 1 所 示 。 
Android 的 单线 程 模式 遵守 的 两 个 规则 : 


。 不 要 阳 寒 给 SampleMcommerce is not 
个 要 阻 守 再 城 程 。 _ responding 

。 不 要 在 UI 线程 之 外 访问 Android 的 UI 组 
件 包 Would you like to close it? 


这 样 , 程 序 才能 有 友好 的 界面 ,顺利 运行 。 一 般 Wait ok 
稍微 复杂 一 点 的 应 用 程序 ,特别 是 需要 网 络 访问 或 
数据 库 访问 的 应 用 程序 ,都 需要 使 用 多 任务 的 方式 。 

在 Android 应 用 程序 中 ,创建 的 Activity Service Broadcast 等 都 是 在 主线 程 (UI 线 
程 ) 处 理 的 ,但 一 些 比较 耗 时 的 操作 ,如 I/O 读 写 的 大 文件 读 写 ,数据 库 操作 以 及 网 络 下 
载 需要 很 长 时 间 , 为 了 不 阻塞 用 户 界面 ,出 现 ANR 的 响应 提示 窗口 ,这 时 可 以 考虑 创建 
一 个 工作 线程 (继承 Thread 类 或 者 实现 Runnable 接口 ) 来 解决 。 


图 6.1 主线 程 阻塞 显示 界面 


6.2 实现 多 任务 


Android 多 任务 的 调度 和 实现 采用 消息 驱动 机 制 。 熟 悉 Windows 编程 的 读者 可 能 
知道 Windows 程序 是 消息 驱动 的 ,并 且 有 全 局 的 消息 循环 系统 。 而 Android 应 用 程序 也 
是 消息 驱动 的 ,Google 参考 了 Windows 系统 ,也 在 Android 系统 中 实现 了 消息 循环 机 
制 。Android 通过 Looper、Handler MessageQueue 和 Message 来 实现 消息 循环 机 制 ， 
Android 消息 循环 是 针对 线程 的 ,就 是 说 主线 程 和 工作 线程 都 可 以 有 自己 的 消息 队列 和 
消息 循环 。 
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对 于 多 线程 的 Android 应 用 程序 来 说 ,有 两 类 线程 : 一 类 是 主线 程 , 也 就 是 UI 线程 ; 
另 一 类 是 工作 线程 ,也 就 是 主线 程 或 工作 线程 所 创建 的 线程 。Android 的 线程 间 消 息 处 
理 机 制 主要 是 用 来 处 理 主线 程 跟 工 作 线 程 间 通信 的 。 图 6. 2 是 线程 间 通 信 原 理 图 。 

Android 应 用 程序 是 通过 消息 来 驱动 的 , 即 在 应 用 程序 的 主线 程 (UI 线 程 ) 中 有 一 个 
消息 循环 ,负责 处 理 消息 队列 中 的 消息 。 

例如 , 当 从 网 上 下 载 文件 时 ,为 了 不 使 主线 程 被 阻塞 ,通常 需要 创建 一 个 子 线程 来 负 
责 下 载 任务 ,同时 ,在 下 载 的 过 程 ,将 下 载 进度 以 百分比 的 形式 在 应 用 程序 的 界面 上 显示 
出 来 ,这 样 就 既 不 会 阻塞 主线 程 的 运行 ,又 能 获得 良好 的 用 户 体验 。 但 是 ,Android 应 用 
程序 的 子 线程 是 不 可 以 操作 主线 程 的 UI 的 ,那么 ,这 个 负责 下 载 任务 的 子 线程 应 该 如 何 
在 应 用 程序 界面 上 显示 下 载 的 进度 呢 ? 如 果 能 够 在 子 线程 中 往 主线 程 的 消息 队列 中 发 送 
消息 ,那么 问题 就 迎刃而解 了 ,因为 发 往 主线 程 消息 队列 的 消息 最 终 是 由 主线 程 来 处 理 
的 ,在 处 理 这 个 消息 的 时 候 , 就 可 以 在 应 用 程序 界面 上 显示 下 载 进度 。 

线程 之 间 和 进程 之 间 是 不 能 直接 传递 消息 的 ,必须 通过 对 消息 队列 和 消息 循环 的 操 
作 来 完成 。Android 消息 循环 是 针对 线程 的 ,每 个 线程 都 可 以 有 自己 的 消息 队列 和 消息 
循环 。Android 提供 了 Handler 类 和 Looper 类 来 来 访问 消息 队列 (Message Queue) 。 


Dd 
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线程 
Handler 
Handler 
UI 线程 


消息 队列 


图 6.2 线程 间 通 信和 原理 图 


Looper 类 是 用 来 封装 消息 循环 和 消息 队列 的 一 个 类 ,负责 管理 线程 的 消息 队列 和 消 
息 循 环 , 用 于 在 Android 线程 中 进行 消息 处 理 。Looper 对 象 是 什么 呢 ? 其 实 Android 中 
每 一 个 线程 都 对 应 一 个 Looper,Looper 可 以 帮助 线程 维护 一 个 消息 队列 ,是 负责 在 多 线 
程 之 间 传 递 消息 的 一 个 循环 器 ,线程 通过 Looper 对 象 可 以 读 写 某 个 消息 循环 队列 。 使 用 
Looper. myLooper( ) 得 到 当前 线程 的 Looper 对 象 ,使 用 Looper. getMainLooper() 可 以 
获得 当前 进程 的 主线 程 的 Looper 对 象 。 

一 个 线程 可 以 存在 ,也 可 以 不 存在 一 个 消息 队列 和 一 个 消息 循环 ,工作 线程 默认 是 没 
有 消息 循环 和 消息 队列 的 ,如 果 想 让 工作 线程 具有 消息 队列 和 消息 循环 ,需要 在 线程 中 首 
先 调用 Looper. prepare() 来 创建 消息 队列 ,然后 调用 Looper. loop() 进 入 消息 循环 , 见 代 
码 6.1。 

代码 6.1 CustomThread. java 


Bs; 
//4. 启动 消息 循环 
Iocper.locp(); 
1 
} 
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通过 代码 6. 1 的 设置 ,工作 线程 CustomThread 就 具有 了 消息 队列 和 消息 循环 的 处 
理 机 制 ,可 以 在 Handler 中 进行 消息 处 理 。 代 码 中 定义 的 Handler 对 象 , 其 作用 是 把 消息 
加 入 特定 的 消息 队列 中 ,并 分 发 和 处 理 该 消息 队列 中 的 消息 。 


每 个 Activity 是 一 个 UI 线程 ,运行 于 主线 程 
Activity 创建 一 个 消息 队列 和 消息 循环 。 


中 。Android 系统 在 启动 的 时 候 会 


一 个 Activity 中 可 以 创建 多 个 工作 线程 或 者 其 他 的 组 件 , 如 果 这 些 线程 或 者 组 件 把 


消息 放 入 Activity 的 主线 程 消息 队列 ,那么 该 消息 
般 负 责 界面 的 更 新 操作 ,并 且 Android 系统 中 的 界 


就 会 在 主线 程 中 处 理 。 因 为 主线 程 一 
面 控件 都 是 单线 程 模式 ,多 线程 控制 需 


要 程序 员 实现 ,也 就 是 非 线程 安全 的 ,所 以 这 种 方式 可 以 很 好 地 实现 Android 界面 更 新 。 


在 Android 系统 中 这 种 机 制 有 着 广泛 的 运用 。 


那么 一 个 工作 线程 怎样 把 消息 放 和 主线 程 的 消息 队列 呢 ? 答案 是 通过 Handler 对 


象 。 只 要 Handler 对 象 由 主线 程 的 Looper 创建 , 


么 调用 Handler 的 sendMessage 等 方 


法 ,就 会 把 消息 放 入 主线 程 的 消息 队列 ;在 主线 程 中 调用 Handler 的 handleMessage 方法 


来 处 理 消息 ,在 这 个 方法 中 实现 主线 程 的 界面 控件 
之 间 的 调度 。 
下 面 是 一 个 简单 的 例子 ,在 Activity 中 定义 了 


的 操作 ,从 而 实现 了 工作 线程 和 主线 程 


Handler 对 象 h, 并 定义 了 一 个 工作 进 


程 MyThread, 在 工作 进程 中 使 用 对 象 h 的 sendMessage 方法 发 送 了 一 条 消息 到 主线 程 


的 消息 队列 , 见 代 码 6. 2。 
代码 6.2 MyHandler. java 


Pblic class MyHandler extends Activity { 
static final String TRG= "Handler"; 
static final int HANDIFR TESI=1; 
Handler b= new Handler () { 
Public void handleMessage Message msg) { 
Switch (msg.what) { 
Case HANDIER TEST: 


Log.d (ThG, “The handler thread id=" 
+ Thread.currentThread() .getId()+" "); 


break; 
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编译 运行 代码 6.2 后 ,可 以 看 到 有 3 条 打印 信息 ,显示 在 这 个 Activity 运行 过 程 中 ， 
各 个 模块 所 处 的 线程 情况 。 

在 这 个 例子 中 ,主线 程 在 onCreate() 方 法 中 通过 new myThread(). start() 启 动 了 工 
作 线 程 , 工 作 线 程 MyThread 中 run() 方 法 中 的 执行 代码 ,访问 了 主线 程 Handler 对 象 h， 
并 在 调用 Handler 的 对 象 h 时 ,向 主线 程 消息 队列 加 入 了 一 条 消息 。 这 个 过 程 中 会 不 会 
出 现 消息 队列 数据 不 一 致 问 题 呢 ? 因为 Handler 对 象 管理 的 Looper 对 象 是 线程 安全 的 ， 
不 管 是 加 入 消息 到 消息 队列 和 从 队列 读 出 消息 都 是 有 同步 对 象 保护 的 , Handler 对 象 不 
会 出 问题 。 由 于 这 里 没有 修改 Handler 对 象 ,所 以 Handler 对 象 不 可 能 会 出 现 数据 不 一 
致 的 问题 。 

工作 线程 和 主线 程 运行 在 不 同 的 线程 中 ,所 以 必须 要 注意 这 两 个 线程 间 的 竞争 关系 。 
在 主线 程 中 构造 Handler 对 象 , 并 且 启 动工 作 线程 之 后 不 要 再 修改 ,否则 会 出 现 数据 不 一 
致 。 这 样 在 工作 线程 中 可 以 放心 地 调用 发 送 消息 SendMessage 等 方法 传递 消息 ， 
Handler 对 象 的 handleMessage 方法 将 会 在 主线 程 中 调用 。 在 这 个 方法 可 以 安全 地 调用 
主线 程 中 任何 变量 和 函数 ,进而 完成 更 新 UI 的 任务 。 

Android 有 两 种 方式 实现 多 线程 操作 UI: 

。 创建 新 线程 Thread, 用 Handler 负责 线程 间 的 通信 和 消息 。 

。 AsyncTask 异步 执行 任务 。 
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下 面 看 看 如 何 使 用 Handler 实现 多 任务 。 
622 用 Hander 实现 多 任务 


android. os. Handler 是 AndroidSDK 中 处 理 定时 操作 的 核心 类 。 通 过 Handler 类 ， 
可 以 提交 和 处 理 一 个 Runnable 对 象 。 这 个 对 象 的 run 方法 可 以 立刻 执行 ,也 可 以 在 指定 
时 间 之 后 执行 (可 以 称 为 预约 执行 ) 。 

Handler 类 有 两 种 主要 用 途 : 

。 按照 时 间 计划 ,在 未 来 某 时 刻 , 对 处 理 一 个 消息 或 执行 某 个 Runnable 实例 。 

。 把 一 个 对 另外 线程 对 象 的 操作 请 求 放 入 消息 队列 中 ,从 而 避免 线程 间 冲 突 。 

当 一 个 进程 启动 时 ,主线 程 独立 执行 一 个 消息 队列 ,该 队列 管理 着 应 用 顶层 的 对 象 
(如 Activities、Broadcast Receivers 等 ) 和 所 有 创建 的 窗口 。 可 以 创建 自己 的 一 个 线程 ， 
并 通过 Handler 来 与 主线 程 进行 通信 。 这 可 以 通过 在 新 的 线程 中 调用 主线 程 的 Handler 
的 postX XXX 和 sendmessage 方法 来 实现 。 

使 用 post 方法 实现 多 任务 的 主要 步骤 如 下 : 

(1) 创建 一 个 Handler 对 象 。 

(2) 将 要 执行 的 操作 写 在 线程 对 象 的 run 方法 中 。 

(3) 使 用 post 方法 运行 线程 对 象 。 

(4) 如 果 需 要 循环 执行 ,需要 在 线程 对 象 的 run 方法 中 再 次 调用 post 方法 。 

代码 6.3 HandlerActivity. java 


Public class Handleractivity extends Activity implements OnClickListener { 
Private Handler countHandler= new Handler (); 
private TextView tvCount; 
Private ProgressBar mProgressBar; 
Private int count= 0; 


Private Rmnable mRinToast= new Runnable() { 
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623 AsycTask 实 现 多 任务 


用 Handler 类 来 在 子 线程 中 更 新 UI 线程 虽然 避免 了 在 主线 程 进行 耗 时 计算 ,但 费 
时 的 任务 操作 总 会 启动 一 些 匿名 的 子 线程 , 太 多 的 子 线程 给 系统 带 来 巨大 的 负担 , 随 之 带 
来 一 些 性 能 问题 。 因 此 Android 提供 了 一 个 工具 类 AsyncTask ,来 实现 异步 执行 任务 。 
AsyncTask 类 善于 处 理 一 些 后 台 的 比较 耗 时 的 任务 ,给 用 户 带 来 良好 用 户 体验 的 ,不 再 
需要 子 线程 和 Handler 就 可 以 完成 异步 操作 并 且 刷 新 用 户 界面 。 

如 果 要 使 用 AsyncTask, 需 要 创建 AsyncTask 类 ,并 实现 其 中 的 抽象 方法 以 及 重 写 
某 些 方法 。 利 用 AsyncTask 不 需要 自己 来 写 后 台 线 程 , 无须 终结 后 台 线 程 ,但 是 
AsyncTask 的 方式 对 循环 调用 的 方式 并 不 太 合 适 。AsyncTask 是 抽象 类 ,AsyncTask 定 
义 了 3 种 泛 型 : Params、Progress 和 Result, 它 们 的 含义 分 别 为 : 

(1) Params: 表示 启动 任务 执行 的 输入 参数 ,例如 HTTP 请 求 的 URL。 

(2) Progress: 表示 后 台 任 务 执行 的 百分比 。 

(3) Result: 表示 后 台 执 行 任务 最 终 返 回 的 结果 ,例如 String、Integer 等 。 

我 们 是 通过 继承 一 个 AsyncTask 类 来 定义 一 个 异步 任务 类 。 

Android 提供 一 个 让 程序 员 编 写 后 台 操 作 更 为 容易 和 透明 AsyncTask, 使 得 后 台 线 
程 能 够 在 UI 主线 程 外 进行 处 理 。 

使 用 AsyncTask, 需 要 创建 AsyncTask 类 ,并 实现 其 中 的 抽象 方法 以 及 重 写 某 些 方 
法 。 利 用 AsyncTask 不 需要 自己 来 写 后 台 线 程 ,无 须 终 结 后 台 线 程 。 

AsyncTask 实现 多 任务 的 步骤 如 下 。 

(1) 使 用 execute 方法 触发 异步 任务 的 执行 。 

(2) 使 用 onPreExecute() 表 示 执 行 预 处 理 ,例如 绘制 一 个 进度 条 控件 。 

(3) 使 用 doInBackground() 用 于 执行 较为 费时 的 操作 ,这 个 方法 是 AsyncTask 的 关 
键 ,必须 覆盖 重 写 。 

(4) 使 用 onProgressUpdate() 对 进度 条 控件 根据 进度 值 做 出 具体 的 响应 。 

(5) 使 用 onPostExecute() 可 以 对 后 台 任 务 的 结果 做 出 处 理 。 

代码 6.4 AsyncTaskActivity. java 


import android.app.Activity; 
import android.o0s.AsyncTask; 
import android.o0s.Bundle; 

import android.widget.ProgressBar; 


jnmport com.tacbao.mcormerce.samrple-Rz 
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} 

retum ™; 
!! 
Boverride 


protected void onProgressUpdate (Integer progress) { 
super.onProgressUpdate (progress); 
ProgressBar.setProgress (progress[0]); 


@ Override 

protected void onPostExecute(String result) { 
super.onPostExecute (result); 
tt.setText (result); 


624 进度 条 
条 


进度 条 (ProgressBar) 是 在 UI 进程 中 显示 工作 进程 进度 的 一 个 重要 工具 。 
ProgressBar 是 Android 提供 的 一 个 进度 条 类 型 ,表示 
运转 的 过 程 ,例如 发 送 短信 、 连 接 网 络 等 ,表示 一 个 过 
旦 正在 执行 中 。 进 度 条 的 样式 主要 有 普通 圆 形 、 超 大 
号 圆 形 .小 号 圆 形 .标题 型 圆 形 等 , 见 图 6. 3。 

1. 普通 圆 形 

对 于 进度 条 的 样式 一 般 只 要 在 XML 布局 中 定义 
就 可 以 。 


图 6.3 进度 条 样式 


< ProgressBar android:id= "@ + android:id/progress" 
android: layout. width= "wrap content" 
android: layout. height= "wrap content"/> 


此 时 ,没有 设置 它 的 风格 ,那么 它 就 是 圆 形 的 ,一 直 会 旋转 的 进度 条 。 

2. 超大 号 圆 形 

此 时 ,给 进度 条 设置 一 个 style 风格 属性 后 ,该 进度 条 就 有 了 一 个 风格 ,这 里 大 号 
ProgressBar 的 风格 是 : 


style= "? android:attr/progressBarstyleLarge" 


3. 小 号 圆 形 
小 号 进度 条 对 应 的 风格 是 : 
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4. 标题 型 圆 形 
标题 型 进度 条 对 应 的 风格 是 : 


代码 6.5 和 代码 6. 6 是 使 用 ProgressBar 类 实现 进度 条 显示 的 例子 。 
代码 6.5 ProgressBarActivity. java 


代码 6.6 progressbar_activity. xml 
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we 
< ProgressBar 
android:layout. width= rap content™" 
android:layout height= "wrap contentm 
style= "@ android:style/Widget.ProgressBar.Smalln 
android:layout marginRight= "5dp"/> 
< TextView 
android:layout. width= "wrap content" 
android:layout height= "wrap content" 
android:text= "@ string/loading"/> 
< /LinearLayout> 


6.3 理解 Service 


Service 是 Android 的 4 大 组 件 之 一 ,用 于 支持 Android 系统 的 服务 。Service 是 一 个 
能 够 在 后 台 执 行 长 时 间 运 行 的 操作 应 用 程序 组 件 ,不 提供 用 户 界面 ,Android 的 其 他 应 用 
的 组 件 可 以 在 后 台 启 动 一 个 Service 运行 ,即使 用 户 切 换 到 另 一 个 应 用 此 Service 也 会 继 
续 运 行 。Android 服务 组 件 就 像 是 Windows 系统 服务 或 者 UNIX 的 守护 进程 ,这 些 都 是 
后 台 而 不 是 可 见 。 

Service 不 能 与 用 户 交 互 ,也 不 能 自己 启动 ,需要 调用 Context. startService ( ) 或 
bindService() 来 启动 ,在 后 台 运 行 。 当 应 用 程序 需要 进行 某 种 不 需要 前 台 显 示 的 计算 或 
数据 处 理 时 ,就 可 以 启动 一 个 Service 来 完成 。 每 个 Service 都 继承 自 android. app 包 下 的 
Service 类 。 每 个 Service 都 必须 在 AndroidManifest. xml 中 通过 二 service 二 进行 声明 。 

Service 具有 自己 的 生命 周期 。Service 服务 的 生命 周期 是 与 Activity 生命 周期 分 离 
的 , 当 Activity 被 暂停 ,停止 或 者 销毁 时 ,Service 组 件 还 可 以 继续 处 理 其 他 任务 。 例 如 ， 
一 个 服务 可 以 处 理 网 络 事务 .播放 音乐 .执行 文件 1/O 或 者 跟 内 容 提 供 器 交互 ,所 有 这 些 
都 是 在 后 台 完 成 的 。 

Android 支持 服务 有 两 个 原因 ,一 是 允许 我 们 方便 地 执行 后 台 任务 ,还 有 就 是 实现 同 
一 设备 上 应 用 之 间 的 跨 进 程 通信 。 基 于 这 两 个 原因 ,Android 系统 支持 两 种 类 型 服务 ,分 
别 是 本 地 服务 和 远程 服务 。 本 地 服务 是 只 可 以 被 驻 留 服务 的 应 用 访问 的 服务 ,而 不 能 被 
本 设备 上 的 其 他 应 用 访问 ;远程 服务 既 可 以 被 其 所 驻 留 的 应 用 访问 ,也 可 以 被 设备 上 的 其 
他 应 用 访问 。 例 如 在 开发 一 个 邮件 应 用 时 ,可 以 创建 一 个 本 地 服务 实现 邮件 的 发 送 ,这 是 
由 于 邮件 的 发 送 需要 网 络 连接 ,这 是 一 个 耗 时 操作 ,需要 后 台 执 行 ;另外 一 种 情况 ,如 果 一 
个 设备 上 很 多 程序 都 需要 一 个 通用 的 翻译 功能 ,可 以 创建 一 个 远程 服务 实现 翻译 功能 ,而 
不 是 在 每 个 应 用 中 都 实现 这 个 功能 。 

Android SDK 包括 了 Service 类 ,其 中 的 代码 封装 了 服务 的 行为 。 但 是 Service 与 上 
面 介绍 的 AsyncTask 不 同 ,Service 对 象 不 会 自动 创建 自己 的 线程 ,而 是 运行 在 服务 的 宿 
主 进程 的 主线 程 中 。 这 就 意味 着 ,如 果 服 务 要 做 一 些 频 繁 的 CPU 工作 (如 MP3 的 回放 或 
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网 络 操作 ) 就 会 阻塞 主线 程 ,应 该 在 这 个 服务 中 创建 一 个 新 的 线程 来 做 这 项 工作 。 通 过 使 
用 一 个 单独 的 线程 ,会 减少 应 用 程序 不 响应 (ANR) 的 错误 风险 ,并 且 应 用 程序 的 主线 程 
能 够 保留 给 用 户 , 专 用 于 跟 Activity 的 交互 。 

如 果 要 创建 一 个 服务 ,有 两 种 方式 : 

(1) 启动 方式 (startService) ,通过 startService() 方 法 启动 。 

(2) 绑 定 方式 (bindService) ,通过 bindService() 方 法 启动 。 

应 用 程序 组 件 可 以 通过 调用 Context. startService( ) 方 法 获得 服务 ,这 个 过 程 也 是 使 
服务 生效 的 过 程 , 例 如 在 Activity 中 调用 startService() 方 法 。 可 以 通过 调用 Context 
. startService() 启动 服务 ;然后 通过 调用 Context. stopService() 或 Service. stopSelf() 停 
止 服 务 。 服 务 一 旦 启动 , 它 就 能 够 无 限期 地 在 后 台 运 行 ,即使 启动 它 的 组 件 被 销毁 。 通 
常 , 一 个 被 启动 的 服务 只 有 一 个 单一 操作 ,并且 不 给 调用 者 返回 结果 。 例 如 ,这 个 服务 可 
能 在 网 络 上 下 载 或 上 传 文件 。 当 操作 完成 的 时 候 ,服务 应 该 自己 终止 。 如 果 仅 以 启动 方 
式 使 用 的 服务 ,这 个 服务 需要 具备 自 管理 的 能 力 , 且 不 需要 通过 方法 调用 向 外 部 组 件 提供 
数据 或 功能 。 

应 用 程序 组 件 也 可 以 通过 调用 bindService() 方 法 启动 和 绑 定 一 个 服务 ,通过 
ServiceConnection 或 直接 获取 服务 中 的 状态 和 数据 信息 。 例 如 使 用 Activity 的 
bindService() 方 法 。 被 绑 定 的 服务 会 提供 一 个 允许 组 件 跟 服 务 交 互 的 客户 端 接口 ,用 于 
发 送 请 求 、, 获 取 结 果 ,甚至 是 跨 进 程 的 进程 间 通 信 实 现 远程 服务 。 应 用 组 件 绑 定 服务 后 ， 
可 以 使 用 ServiceConnection 获取 服务 对 象 , 并 且 调 用 服务 中 的 方法 。 应 用 组 件 通 过 
Context . bindService() 方法 绑 定 服务 ,并 且 建 立 ServiceConnection; 通过 Context 
.unbindService() 方法 解除 绑 定 ,并 且 停 止 ServiceConnection。 如 果 在 绑 定 过 程 中 服务 
没有 启动 , Context. bindService ( ) 会 自动 启动 服务 。 同 一 个 服务 可 以 绑 定 多 个 
ServiceConnection ,这 样 可 以 同时 为 多 个 不 同 的 组 件 提供 服务 。 一 个 被 绑 定 服务 的 运行 
时 间 跟 绑 定 它 的 应 用 程序 组 件 一 样 长 。 多 个 组 件 能 够 绑 定 一 个 服务 ,但 是 只 有 所 有 这 些 
绑 定 被 解 绑 后 ,这 个 服务 才 被 销毁 。 

这 两 种 获得 服务 的 方法 并 不 是 完全 独立 的 ,在 某 些 情况 下 可 以 混合 使 用 。 例 如 在 
MP3 播放 器 中 ,可 以 通过 Context. startService( ) 方 法 启动 音乐 播放 的 后 台 服 务 ,但 在 播 
放 过 程 中 如 果 用 户 需 要 和 暂停 音乐 播放 , 则 需要 通过 Context, bindService( ) 获取 
ServiceConnection 和 服务 对 象 .进而 通过 调用 服务 对 象 中 的 方法 暂停 音乐 播放 ,并 保存 
相关 信息 。 在 这 种 情况 下 ,如 果 调 用 Context. stopService() 并 不 能 够 停止 Service, 需 要 
在 所 有 的 ServiceConnection 关闭 后 ,Service 才能 够 真正 地 停止 。 

无 论 使 用 上 述 两 种 方式 的 一 种 ,还 是 同时 使 用 这 两 种 方式 获得 服务 ,都 需要 使 用 到 
Intent, 这 与 获得 Activity 组 件 的 方式 相同 。 
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虽然 服务 的 生命 周期 比 Activity 的 生命 周期 简单 ,但 服务 的 生命 周期 非常 重要 。 
为 服务 在 后 台 运 行 ,有 时 用 户 甚至 意识 不 到 它 的 存在 ,所 以 更 多 关注 于 服务 如 何 创建 和 销 
毁 。 服 务 的 生命 周期 根据 创建 一 个 服务 的 方式 不 同 而 有 所 不 同 , 见 图 6.4, 分 别 是 启动 方 
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式 和 绑 定 方式 创建 服务 的 生命 周期 。 
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图 6.4 Service 的 生命 周期 


使 用 启动 方式 (startService) 创建 服务 时 ,一 个 组 件 调 用 startService() 方 法 创建 服 
务 , 然 后 服务 无 限期 地 运行 ,并 且 必 须 通 过 调用 stopSelf() 方 法 来 终止 自己 。 其 他 组 件 也 
能 够 通过 调用 stopService() 方 法 来 终止 这 个 服务 。 当 服务 被 终止 ,系统 就 会 把 它 销毁 。 

使 用 绑 定 方式 (bindService) 创 建 服 务 时 , 当 有 一 个 组 件 调 用 bindService() 方 法 时 , 服 
务 就 会 被 绑 定 ,客户 端 通过 IBinder 接口 与 服务 通信 。 客 户 端 能 够 调用 unbindService() 
方法 来 解除 与 服务 的 绑 定 。 可 以 有 多 个 客户 端 绑 定 到 一 个 服务 上 ,但 是 当 所 有 的 绑 定 都 
被 解除 以 后 ,系统 才 会 销毁 这 个 服务 ,而 服务 不 需要 终止 自己 。 

但 是 ,这 两 种 是 完全 独立 的 ,能 够 绑 定 一 个 已 经 用 startService() 方 法 启动 的 服务 。 
例如 ,可 以 通过 调用 startService() 方 法 启动 后 台 的 音乐 服务 ,这 个 方法 使 用 Intent 标识 
了 要 播放 的 音乐 ;之 后 如 果 用 户 想 要 进行 一 些 播放 器 的 控制 时 ,或 想 要 获取 有 关 当 前 歌曲 
信息 时 ,可 以 在 一 个 Activity 中 通过 调用 bindService( ) 方 法 来 绑 定 这 个 服务 。 这 时 直到 
所 有 的 客户 端 解 除 绑 定 后 ,stopService() 或 stopSelf() 方 法 才能 实际 终止 这 个 服务 。 

要 创建 一 个 服务 ,必须 创建 一 个 Service 类 的 子 类 。Service 实现 中 ,需要 重 写 一 些 处 
理 服务 生命 周期 关键 特征 的 回调 方法 ,并 且 给 组 件 提 供 一 种 合适 的 绑 定 服务 的 机 制 。 

需要 重 写 的 回调 方法 包括 : 
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(1) onStartCommand() : 当 一 个 组 件 通过 调用 startService() 方 法 请 求 启 动 一 个 服 
务 时 ,系统 会 调用 这 个 服务 的 onStartCommand() 方 法 。 一 旦 这 个 方法 执行 了 ,那么 这 个 
服务 就 被 启动 ,并 且 在 后 台 无 限期 地 和 运行。 实现 了 这 个 方法 , 当 服务 的 工作 结束 时 ,必须 
调用 stopSelf() 方 法 或 stopService() 方 法 来 终止 服务 。 如 果 只 让 服务 提供 绑 定 的 能 力 ， 
不 需要 实现 这 个 方法 。 

(2) onBind(): 当 一 个 组 件 想 通过 调用 bindService() 方 法 跟 这 个 服务 (如 执行 RPC) 
绑 定时 ,系统 会 调用 这 个 方法 。 在 这 个 方法 的 实现 中 ,必须 通过 返回 一 个 IBinder 对 象 给 
客户 提供 一 个 用 户 跟 服务 进行 交互 的 接口 。 这 个 方法 必须 实现 ,如 果 你 不 允许 绑 定 ,那么 
这 个 方法 应 该 返回 null。 

(3) onCreate(): 当 服 务 被 第 一 次 创建 时 ,系统 会 调用 这 个 方法 来 执行 一 次 安装 过 
程 。 这 个 方法 在 onStartCommand() 或 onBind() 方 法 之 前 调用 。 如 果 服 务 正 在 运行 ,这 
个 方法 就 不 会 被 调用 。 

(4) onDestroy(): 当 服 务 不 再 使 用 或 正在 销毁 时 ,系统 会 调用 这 个 方法 。 服 务 需要 
使 用 这 个 方法 来 实现 一 些 清理 资源 的 工作 ,如 清理 线程 .被 注册 的 监听 器 、 接 收 器 等 。 这 
是 服务 能 够 接收 最 后 的 调用 。 

如 果 组 件 通过 调用 startService() 方 法 启动 服务 ,这 样 会 调用 服务 onStartCommand() 
方法 ,那么 这 个 服务 就 会 一 直 运 行 , 一 直到 它 自己 用 stopSelf() 方 法 终止 服务 ;或 男 一 个 
组 件 通 过 调用 stopService() 方 法 来 终止 它 。 如 果 一 个 组 件 调用 bindService() 方 法 来 创 
建 这 个 服务 ,并 且 没 有 调用 onStartCommand() 方 法 ,那么 这 个 服务 的 运行 时 间 与 绑 定 它 
的 组 件 运行 时 间 一 样 长 ,一旦 这 个 服务 从 所 有 的 客户 端 解 绑 , 系 统 就 会 销毁 它 , 而 不 需 服 
务 自己 或 其 他 组 件 停止 。 

Android 系统 只 有 在 内 存 不 足 , 并 且 为 用 户 提供 界面 响应 而 必须 释放 系统 资源 时 , 才 
会 强制 终止 一 个 服务 。 如 果 服 务 是 被 一 个 正在 与 用 户 进 行 交 互 的 Activity 绑 定 ,那么 它 
被 杀 死 的 可 能 性 很 小 ;如 果 这 个 服务 被 声明 运行 在 前 台 , 那 么 它 也 几乎 不 能 被 杀 死 。 但 
是 ,如 果 这 个 服务 被 启动 并 且 长 时 间 运 行 ,那么 随 着 时 间 的 推移 系统 会 降低 它 在 后 台 任 务 
列表 中 位 置 ,并 且 这 个 服务 将 很 容易 被 杀 死 ;如 果 服 务 是 组 件 通过 startService() 方 法 启 
动 了 ,那么 必须 把 它 设 计 成 能 够 通过 系统 妥善 地 处 理 重 启 。 如 果 系 统 为 了 释放 资源 杀 死 
了 服务 ,就 需要 当 资 源 可 用 时 怎样 有 效 重启 服务 ,当然 这 依赖 于 onStartCommand() 方 法 
的 返回 值 。 

像 Activity 一 样 ,服务 也 有 生命 周期 回调 方法 ,可 以 通过 实现 这 些 回 调 方法 来 监测 服 
务 内 状态 的 改变 ,在 合适 的 时 机 执行 工作 。 代 码 6.7 示例 了 每 个 生命 周期 的 回调 方法 。 

代码 6.7 ExampleService. java 

public class Exampleservice extends service { 

int mStartMpde; //indicates how to behave if the service is Killed 
JIBinder mBinder; //interface for clients that bind 


@oOverride 
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像 Activity 一 样 , 所 有 的 服务 都 必须 在 应 用 程序 的 清单 文件 中 声明 。 要 声明 服务 就 
要 给 二 application 过 元 素 添加 一 个 二 service 二 子 元 素 ,例如 


在 二 service 盖 元 素 中 还 包括 了 一 些 其 他 的 属性 定义 ,如 启动 服务 所 需 的 许可 和 服务 
应 该 运行 在 哪个 进程 中 。android:name 属性 是 唯一 必需 的 属性 , 它 指 定 了 这 个 服务 的 类 
名 。 一 旦 应 用 发 布 , 就 不 应 该 改变 这 个 名 字 , 如 果 修 改 了 ,就 会 中 断 那些 使 用 Intent 引用 
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这 个 服务 的 功能 。 关 于 在 清单 文件 中 声明 服务 的 更 多 信息 ,请 参考 一 service 二 元 素 的 说 明 。 

就 像 Activity 一 样 ,一 个 服务 也 能 够 定义 Intent 过 滤器 ,允许 其 他 组 件 使 用 隐 含 的 
Intent 来 调用 这 个 服务 。 通 过 声明 Intent 过 滤器 ,安装 在 用 户 设备 上 的 任何 应 用 程序 组 
件 都 能 在 符合 条 件 下 启动 该 服务 。 
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Android 的 一 个 组 件 可 以 通过 调用 startService() 方 法 创建 一 个 启动 类 型 的 Service， 
并 调用 服务 的 onStartCommand() 方 法 来 启动 的 服务 。 如 果 一 个 服务 被 启动 , 它 就 具有 
了 一 个 独立 于 启动 它 的 组 件 的 生命 周期 ,并 且 这 个 服务 能 够 无 限期 地 在 后 台 运 行 ,即使 启 
动 它 的 组 件 被 销毁 。 

Activity 之 类 的 应 用 程序 组 件 在 通过 调用 startService() 方 法 来 启动 Service 时 ,需要 
给 指定 的 Service 传递 一 个 Intent 对 象 , 携带 一 些 服 务 所 使 用 的 数据 。Service 在 
onStartCommand( ) 方 法 中 接收 这 个 Intent 对 象 。 例 如 ,假设 一 个 Activity 需要 把 一 些 数 
据 保存 到 在 线 数据 库 中 。 这 个 Activity 就 能 启动 一 个 服务 ,并且 把 要 保存 的 数据 通过 一 
个 Intent 对 象 传递 给 startService() 方 法 。 这 个 服务 在 onStartCommand() 方 法 中 接收 这 
个 Intent 对 象 ,连接 到 互联 网 ,并 且 执 行 数据 库 事 务 。 当 事务 结束 ,这 个 服务 就 自己 终止 
并 销毁 。 

但 是 ,服务 运行 的 进程 与 声明 它 的 应 用 程序 的 进程 是 同一 个 进程 ,并 且 是 在 应 用 程序 
的 主线 程 中 。 上 默认 情况 下 ,如 果 服 务 要 执行 密集 或 阻塞 操作 ,而 用 户 又 要 跟 同一 个 应 用 程 
序 的 一 个 Activity 进行 交互 ,那么 这 个 服务 就 会 降低 Activity 的 性 能 。 要 避免 影响 应 用 
程序 的 性 能 ,需要 在 服务 的 内 部 启动 一 个 新 的 线程 。 

创建 启动 类 型 的 服务 ,通常 可 以 通过 两 种 方式 来 实现 : 

(1) 继承 Service: Service 是 所 有 服务 的 基 类 。 当 通过 继承 这 个 类 创建 启动 类 型 服 
务 时 ,重要 的 是 要 给 这 个 服务 创建 一 个 新 的 线程 ,避免 其 占用 应 用 程序 的 主线 程 ,影响 正 
在 运行 的 Activity 的 性 能 。 

(2) 继承 IntentService: IntentService 是 Service 类 的 子 类 , 它 可 以 使 用 工作 线程 来 
依次 处 理 所 有 的 启动 请 求 , 如 果 所 需 创 建 的 服务 不 用 同时 处 理 多 个 请 求 , 那 么 这 是 最 好 的 
选择 。 当 通过 继承 这 个 类 创建 启动 类 型 服务 时 ,需要 做 的 所 有 工作 就 是 实现 
onHandleIntent() 方 法 , 它 接收 每 个 启动 请 求 的 Intent 对 象 , 以 便 完成 后 台 工 作 。 

1. IntentService 

IntentService 是 Service 类 的 子 类 ,用 于 处 理 异 步 请 求 。 因 为 大 多 被 启动 类 型 的 服务 
不 需要 同时 处 理 多 个 请 求 ,所 以 使 用 IntentService 类 来 实现 自己 的 服务 可 能 是 最 好 的 选 
择 。 客 户 端 可 以 通过 startService(Intent) 方 法 传递 请 求 给 IntentService。 

首先 分 析 IntentService 源 代码 。 代 码 6. 8 是 IntentService 抽象 类 的 具体 定义 代码 。 
从 IntentService 的 定义 中 可 以 看 出 ,IntentService 实际 上 是 Looper、Handler、Service 的 
集合 体 , 它 不 仅 有 服务 的 功能 ,还 有 消息 处 理 和 消息 循环 的 功能 。 
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代码 6.8 IntentService. java 
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IntentService 在 处 理事 务 时 ,还 是 采用 的 Handler 方式 ,创建 一 个 名 叫 Service- 
Handler 的 内 部 Handler, 并 把 它 直接 绑 定 到 HandlerThread 所 对 应 的 子 线程 。 

ServiceHandler 把 处 理 Intent 所 对 应 的 事务 的 代码 都 封装 到 叫做 onHandleIntent() 
回调 方法 中 ,因此 直接 实现 onHandleIntent() 方 法 ,再 在 里 面 根据 Intent 的 不 同 进行 不 同 
的 事务 处 理 就 可 以 。 另 外 ,IntentService 默认 实现 了 onBind() 方 法 ,返回 值 为 null。 

继承 IntentService 的 好 处 是 处 理 异 步 请 求 的 时 候 可 以 减少 写 代码 的 工作 量 , 比 较 轻 
松 地 实现 项 目的 需求 。IntentService 的 构造 方法 一 定 是 参数 为 空 的 构造 方法 ,然后 在 其 
中 调用 父 类 的 构造 方法 super("name")。 因 为 Service 的 实例 化 是 系统 来 完成 的 ,而 且 系 
统 是 用 参数 为 空 的 构造 方法 来 实例 化 Service 的 ,所 以 只 需要 实现 onHandleIntent() 方 
法 ,来 完成 由 客户 提供 的 工作 。 

下 面 是 一 个 使 用 IntentService 创建 启动 服务 的 简单 例子 ,在 onHandleIntent() 方 法 
中 实现 了 模拟 download 文件 时 耗 时 的 状况 ,具体 实现 见 代 码 6.9。 
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代码 6.9 HelloIntentService. java 


代码 6. 9 中 只 是 定义 了 一 个 构造 方法 和 onHandleIntent() 方 法 ,如 果 还 要 重 写 
onCreate() .onStartCommand() 或 onDestroy() 其 他 的 回调 方法 时 ,必须 要 调用 父 类 相同 
的 回调 方法 ,以 便 IntentService 对 象 能 够 适当 地 处 理工 作 线 程 的 活动 。 例 如 ,要 在 代码 
6.9 中 添加 onStartCommand() 方 法 的 实现 代码 , 则 在 这 个 方法 的 实现 代码 中 ,必须 执行 
语句 super。onStartCommand ( ) 来 调用 父 类 的 同一 个 回调 方法 ,使 得 本 类 的 
onStartCommand() 方 法 获取 Intent 并 将 其 交付 给 onHandleIntent() 方 法 。 
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除了 onHandleIntent() 方 法 以 外 ,唯一 不 需要 调用 实现 的 方法 是 onBind() 方 法 ,如 
果 服 务 允 许 绑 定 ,就 要 实现 这 个 方法 。 

2. Service 

继承 IntentService 类 来 实现 一 个 被 启动 类 型 的 服务 很 简单 ,如 果 服 务 要 执行 多 线 
程 ,而 不 是 通过 工作 队列 来 处 理 启 动 请 求 ,那么 就 需要 定义 Service 类 的 子 类 来 处 理 每 个 
Intent 。 

为 便于 比较 ,在 代码 6. 10 例子 中 ,使 用 继承 Service 类 的 方式 创建 了 一 个 服务 ,执行 
了 与 上 一 节 继 承 IntentService 类 的 代码 6. 9 相同 的 工作 。 但 与 代码 6. 9 的 处 理 方式 不 
同 , 其 对 于 每 个 启动 请 求 , 它 都 会 使 用 一 个 工作 线程 来 执行 工作 ,并 且 每 次 只 处 理 一 个 
请 求 。 

代码 6.10 HelloService. java 
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在 代码 6. 10 中 ,Service 创建 时 会 调用 onCreate() 方 法 。 在 onCreate() 方 法 中 创建 
Handler 线程 (HandlerThread) 后 启动 此 线程 .然后 获取 当前 线程 的 Looper 对 象 来 初始 
化 Service 的 mServiceLooper, 并 创建 mServicehandler 对 象 。 
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当 一 个 组 件 通 过 调用 startService() 方 法 请 求 启动 一 个 服务 时 ,系统 会 调用 这 个 服务 
的 onStartCommand() 方 法 。 对 于 每 一 个 启动 Service 的 请 求 ,都 会 产生 一 条 带 有 startId 
和 Intent 的 Message, 并 发 送 到 MessageQueue 中 。ServiceHandler 通过 继承 Handler 来 
实现 服务 请 求 的 多 任务 处 理 ,具体 的 原理 和 细节 可 以 参考 6. 2 节 内 容 。 

继承 Service 实现 服务 比 继承 IntentService 类 多 做 很 多 工作 。 因 为 我 们 处 理 每 个 
onStartCommand() 方 法 的 调用 ,所 以 就 能 够 同时 执行 多 个 请 求 。 在 代码 6. 10 例子 中 没 
有 这 么 做 ,但 是 ,如 果 想 要 这 么 做 ,那么 可 以 给 每 个 请 求 创建 一 个 新 的 线程 ,并 且 立 即 运行 
它们 ,而 不 需要 等 待 前 一 个 请 求 完成 。 

3. 启动 和 终止 服务 

Android 的 一 个 组 件 可 以 通过 调用 startService() 方 法 创建 一 个 启动 类 型 的 Service， 
并 调用 服务 的 onStartCommand() 方 法 来 启动 的 服务 。 

当 一 个 服务 定义 完成 后 ,可 以 在 其 他 组 件 中 通过 创建 符合 条 件 的 Intent 对 象 或 显示 
指定 要 启动 的 服务 ,并 且 将 其 传递 给 startService( ) 方 法 ,这 样 就 可 以 实现 从 一 个 Activity 
或 其 他 的 应 用 程序 组 件 启动 服务 。 例 如 ,在 Activity 的 onCreate() 代 码 中 添加 如 下 代码 ， 
能 够 创建 显示 指定 的 Intent 对 象 ,并 把 其 作为 startService() 方 法 的 参数 来 启动 指定 的 
HelloService 服务 。 


Intent intent= new Intent (this, HelloServioe.class); 
startService (intent); 


服务 一 旦 运行 ,就 能 够 使 用 广播 通知 (Toast Notifications) 或 状态 栏 通知 (Status Bar 
Notifications) 来 通知 有 用户。 通常, 状态 栏 通知 是 用 来 告知 后 台 任 务 完成 的 最 好 的 技术 (如 
文件 下 载 完 成 ) ,并 且 用 户 能 够 采取 相应 的 动作 。 

启动 类 型 的 服务 必须 管理 它 自己 的 生命 周期 ,除非 系统 要 回收 系统 内 存 , 和 否则 系统 不 
会 终止 或 销毁 这 个 服务 。 因 此 而 这 种 类 型 的 服务 必须 通过 调用 stopSelf() 方 法 或 另 一 个 
组 件 通过 调用 stopService() 方 法 才能 终止 。 一 旦 用 stopSelf() 方 法 或 stopService() 方 法 
请 求 终 止 服务 ,那么 系统 一 有 可 能 就 会 销毁 这 个 服务 。 
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绑 定 类 型 服务 允许 组 件 ( 如 Activity) 绑 定 服务 ,实现 发 送 请 求 、 接 收 响应 以 及 执行 进 
程 间 通信 。 一 个 典型 的 绑 定 类 型 的 服务 只 跟 它 所 绑 定 的 应 用 程序 组 件 同时 存在 ,并 且 不 
在 后 台 无 限期 地 运行 。 绑 定 类 型 的 服务 是 客户 端 和 服务 端 之 间 交 互 的 服务 端 。 

要 创建 绑 定 类 型 的 服务 ,首先 要 定义 接口 ,用 于 指定 客户 端 怎样 跟 服务 进行 通信 。 服 
务 和 客户 端的 之 间 的 接口 必须 是 一 个 IBinder 接口 的 实现 ,并 且 要 求 必 须 从 onBind() 回 
调 方法 返回 这 个 IBinder 接口 对 象 。 一 旦 客户 端 收 到 IBinder 对 象 , 它 就 能 通过 这 个 接口 
开始 与 服务 进行 交互 。 多 个 客户 端 能 够 同时 绑 定 这 个 服务 。 当 客户 端 完 成 与 服务 的 交互 
时 , 它 调用 unbindService() 方 法 来 解 贿 。 一 旦 没有 客户 端 绑 定 这 个 服务 ,系统 就 会 销 
毁 它 。 

客户 端 通过 调用 bindService( ) 方 法 绑 定 服务 。 客 户 端 绑 定 服务 时 ,必须 提供 
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ServiceConnection 类 的 对 象 , 并 且 实 现 其 方法 ,用 来 监视 服务 端的 连接 。bindService() 方 
法 不 带 返回 值 , 并 立即 返回 ,但 是 当 Android 系统 在 客户 端 和 服务 端 创建 连接 时 , 它 会 在 
ServiceConnection 方法 上 调用 onServiceConnected( ) 方 法 来 发 送 客户 端 跟 服务 端 进行 交 
互 用 的 IBinder 对 象 。 

多 个 客户 端 能 够 连接 到 同一 个 服务 上 ,但 是 只 在 第 一 个 客户 端 绑 定 时 ,系统 调用 服务 
的 onBind() 方 法 来 发 送 获取 对 象 。 然 后 系统 会 给 其 他 任何 绑 定 的 客户 端 发 送 相同 的 
IBinder 对 象 ,而 不 会 再 次 调用 onBind() 方 法 。 当 最 后 的 客户 端 从 服务 上 解 绑 , 系 统 就 会 
销毁 这 个 服务 ,但 这 个 服务 也 通过 startService() 方 法 启动 了 情况 除外 。 

在 实现 绑 定 类 型 的 服务 时 ,最 重要 的 部 分 是 定义 onBind() 回 调 方法 返回 的 接口 。 有 
很 多 不 同 的 方法 能 够 定义 服务 的 IBinder 接口 ,在 这 一 节 下 面 的 内 容 中 会 分 别 讨论 这 些 
技术 。 有 3 种 方法 能 够 定义 这 个 接口 。 

1. 继承 Binder 

如 果 服 务 对 应 用 程序 来 说 是 私有 服务 ,并 且 跟 客户 端 运 行 在 同一 个 进程 中 ,也 就 是 为 
本 地 服务 ,那么 就 应 该 通过 继承 Binder 类 来 创建 接口 ,并 且 通 过 onBind() 方 法 返回 这 个 
接口 的 一 个 实例 。 客 户 端 接收 这 个 Binder 对 象 , 并 且 能 够 直接 访问 其 实现 的 或 Service 
中 的 公共 方法 。 如 果 只 是 在 后 台 我 们 自己 的 应 用 程序 提供 服务 ,这 是 首选 方法 。 只 有 被 
其 他 应 用 程序 或 者 跨 进 程 使 用 时 , 才 考虑 使 用 其 他 方法 。 

2. 使 用 Messenger 

如 果 接口 要 跨越 不 同 进 程 来 进行 工作 ,那么 用 Messenger 信使 给 服务 创建 接口 。 在 
这 种 方式 中 ,服务 定义 了 响应 不 同 消息 对 象 类 型 的 处 理 器 。 这 个 处 理 器 是 一 个 信使 的 基 
础 , 它 能 够 跟 客 户 端 共享 一 个 IBinder 对 象 ,允许 客户 端 使 用 Messenger 对 象 给 服务 端 发 
送 命令 。 另 外 ,客户 端 能 够 定义 一 个 自己 的 信使 ,以 便服 务 端 能 够 给 客户 端 发 送 消息 。 这 
是 执行 进程 间 通信 (CIPC) 最 简单 的 方法 ,因为 信使 队列 的 所 有 请 求 都 在 一 个 单线 程 中 , 因 
此 不 需要 针对 线程 安全 来 设计 服务 。 

3. 使 用 AIDL 

AIDL 为 接口 定义 语言 (Android Interface Definition Language) ,用 来 将 对 象 分 解 成 
操作 系统 能 够 理解 的 原 语 , 并 且 将 它们 在 进程 之 间 编 组 ,完成 进程 间 通 信 。Messenger 技 
术 实 际 上 是 基于 AIDL 架构 。 就 像 前 面 提 到 的 ,Messenger 在 一 个 单线 程 中 创建 了 一 个 
所 有 客户 端 请 求 的 队列 ,因此 服务 每 次 只 能 接收 一 个 请 求 。 如 果 想 要 同时 处 理 多 个 请 求 ， 
那么 可 以 直接 使 用 AIDL。 这 种 情况 下 ,我们 的 服务 必须 是 多 线程 的 并 且 要 线程 安全 。 
要 使 用 直接 AIDL ,就 必须 创建 一 个 定义 编程 接口 的 . aidl 文件 。Android SDK 使 用 这 个 
文件 生成 一 个 实现 文件 中 定义 的 接口 和 处 理 IPC 的 抽象 类 ,然后 能 够 在 服务 中 进行 扩 
展 。 大 多 数 应 用 程序 不 应 该 使 用 AIDL 方法 来 创建 绑 定 类 型 的 服务 ,因为 它 可 能 需要 多 
线程 的 能 力 ,并 可 能 导致 更 复杂 的 实现 ,因此 AIDL 不 适 于 大 多 数 应 用 程序 。 


6.3.3.1 继承 Binder 类 


如 果 只 在 应 用 程序 的 局 部 使 用 服务 .并 且 不 需要 跨 进程 工作 ,程序 员 可 以 实现 自己 的 
Binder 类 ,用 它 直 接 为 客户 端 提供 访问 服务 。 通 常 ,客户 端 和 服务 端 只 是 在 同一 个 应 用 
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和 进程 中 工作 ,不 为 第 三 方 应 用 程序 提供 服务 。 例 如 ,对 于 一 个 需要 良好 工作 的 播放 音乐 
的 应 用 程序 ,就 需要 把 在 后 台 工 作 的 播放 音乐 的 服务 与 应 用 自己 的 一 个 Activity 绑 定 。 
使 用 继承 Binder 类 来 定义 服务 的 IPBinder 接口 的 步 又 如 下 : 
(1) 在 Service 中 创建 一 个 Binder 的 实例 : 
。 这 个 实例 包含 Client 可 以 调用 的 public 方法 ; 
。 这 个 实例 返回 当前 Service 对 象 ,其 包含 Client 可 以 调用 的 public 方法 ; 
。 这 个 实例 返回 Service 类 中 的 一 个 类 对 象 ,而 这 个 类 对 象 包含 Client 可 以 调用 的 
public 方法 。 
(2) 在 Service 的 onBind() 方 法 中 返回 这 个 Binder 实例 。 
(3) 在 Client 端的 onServiceConnected() 方 法 中 获得 这 个 Binder 实例 ,并 通过 这 个 
Binder 实例 调用 Service 端的 public 方法 。 
服务 端 和 客户 端 必须 在 同一 个 应 用 ,原因 是 客户 端 能 够 转换 返回 的 对 象 , 并 正确 地 调 
用 自己 的 API。 服 务 端 和 客户 端 也 必须 是 在 同一 个 进程 中 ,因为 这 种 技术 不 执行 任何 跨 
进程 处 理 。 代 码 6. 11 是 通过 继承 Binder 绑 定 服务 的 一 个 简单 例子 。 
代码 6.11 LocalService. java 
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在 代码 6. 11 中 , LocalBinder 对 象 给 客户 端 提 供 了 getService ( ) 方法 ,并 在 
LocalService 的 成 员 变 量 定义 时 ,通过 实例 化 IBinder 变量 返回 当前 服务 的 实例 ,使 得 客 
户 端 用 这 个 方法 能 够 获取 LocalService 服务 的 当前 实例 。 这 样 就 允许 客户 端 调用 服务 中 
的 public 方 法 。 

完成 服务 本 身 的 定义 后 ,第 三 步 就 是 从 客户 端 绑 定 定义 完成 的 服务 。 所 谓 客 户 端 ,就 
是 需要 与 服务 绑 定 的 Activity 之 类 的 组 件 。 这 需要 在 组 件 中 做 几 个 工作 : 

(1) 重 写 两 个 回调 方法 onServiceConnected() 和 OnServiceDisconnected() , 实现 
ServiceConnection()。 

(2) 调用 bindService() , 传 给 ServiceConnection 的 实现 。 

(3) 使 用 接口 定义 的 方法 调用 Service。 

(4) 在 需要 与 Service 断 开 绑 定 连接 时 ,调用 unbindService()。 

下 面 代码 6. 12 是 一 个 例子 ,Activity 代码 绑 定 了 LocalService 服务 ,并 且 在 单 击 按钮 
时 调用 了 服务 public 方法 : getRandomNumber() 方 法 。 

代码 6.12 BindingActivity. java 
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代码 6. 12 显示 了 客户 端 是 怎样 使 用 ServiceConnection 接口 和 onServiceConnected 
回调 方法 的 实现 来 绑 定 服务 的 。 
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6.3.3.2 使 用 Messenger 


如 果 服 务 需 要 与 远程 进程 通信 ,就 可 以 使 用 Messenger 对 象 来 给 服务 提供 接口 。 使 
用 这 种 方式 定义 服务 与 客户 端的 接口 需要 的 步骤 如 下 。 

(1) 在 Service 内 部 实现 Handler 接口 ,用 于 处 理 从 每 一 个 Client 发 送 来 的 请 求 。 

(2) 使 用 这 个 Handler 创建 一 个 Messenger 对 象 。 

(3) 这 个 Messenger 在 Service 的 onBind() 方 法 中 创建 一 个 IBinder 实例 ,返回 给 
Client。 

(4) Client 使 用 从 Service 返回 的 IBinder 实例 来 初始 化 一 个 Messenger, 然 后 用 其 给 
Service 发 送 Message 对 象 。 

(5) Service 在 它 的 处 理 器 (Handler) 的 handleMessage() 方 法 中 依次 接收 每 个 
Message 对 象 ,进行 处 理 。 

使 用 这 种 方法 的 过 程 中 ,客户 端 没有 调用 服务 端的 任何 方法 ,相反 客户 端 会 给 发 送 服 
务 端 Message 对 象 , 服 务 端 会 在 它 的 处 理 器 中 接收 这 些 消 息 对 象 。 

下 面 是 一 个 例子 ,说 明了 如 何 使 用 Messenger 接口 定义 绑 定 的 服务 , 见 代码 6. 13。 

代码 6. 13 MessengerService. java 
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代码 6. 13 中 IncomingHandler 类 里 定义 的 handleMessage() 方 法 ,能 够 接收 客户 端 
输入 的 Message 对 象 ,并 根据 Message 的 what 成 员 属 性 作出 判断 。 客 户 端 需要 做 的 所 
有 工作 就 是 基于 服务 端 返回 的 IBinder 对 象 创建 一 个 Messenger 对 象 ,并 且 使 用 这 个 
Messenger 对 象 的 send() 方 法 发 送 消息 。 

下 面 的 例子 是 一 个 简单 的 Activity 代码 , 它 作为 客户 端 绑 定 服务 ,并 且 给 服务 发 送 
MSG_SAY_HELLO 消息 , 见 代 码 6. 14。 

代码 6.14 ActivityMessenger. java 
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在 前 面 的 例子 中 ,通过 Messager 定义 接口 ,实现 了 Client 向 Service 发 送 消 息 ， 
Service 中 的 Handler 对 消息 作出 响应 和 处 理 。 但 这 个 例子 实现 的 仅 是 单 向 通信 , 即 
Client 给 Service 发 送 消息 ,并 没有 实现 Service 处 理 完成 后 向 Client 发 送 消息 。 如 果 需 
要 Service 给 Client 发 送 消息 又 该 如 何 实现 呢 ? 

这 个 实现 的 过 程 与 前 面 5 步 类 似 ,只 是 Client 和 Service 在 实现 过 程 中 角色 有 所 变 
化 。 可 以 接着 上 面 的 步骤 继续 来 实现 双向 通信 。 

(6) 在 Client 中 创建 一 个 Handler 对 象 ,用 于 处 理 Service 发 过 来 的 消息 。 

(7) 使 用 Client 中 的 这 个 Handler 对 象 创建 一 个 Client 自己 的 Messenger 对 象 。 

(8) 在 前 面 第 4 步 ,客户 端 获 取 了 Service 的 Messenger 对 象 ,并 通过 它 来 给 Service 
发 送 消息 。 在 向 Service 发 送 消息 之 前 ,将 Message 对 象 的 replyTo 字段 设置 成 第 7 步 创 
建 的 Messenger 对 象 。 

(9) Service 的 Handler 处 理 Message 时 ,将 Message 对 象 的 replyTo 字段 提取 出 
来 ,并 用 它 给 Client 发 送 消 息 。 

这 样 我 们 就 实现 了 Client 和 Service 的 双向 通信 。Client 和 Service 都 有 自己 的 
Handler 和 Messenger 对 象 , 使 得 对 方 可 以 给 自己 发 送 消 息 。Client 的 Messenger 是 通 
过 Message 的 replyTo 传递 给 Service 的 。 


6.4 小 结 


本 章 主要 介绍 了 Android 系统 多 任务 的 机 制 和 Service 这 个 基本 的 组 件 。 

Android 多 任务 的 调度 和 实现 采用 消息 驱动 机 制 。 应 用 程序 启动 时 ,系统 会 为 它 创 
建 一 个 名 为 main 的 主线 程 。 默 认 情 况 下 ,同一 个 应 用 程序 的 所 有 组 件 都 运行 在 同一 个 进 
程 的 “主线 程 ” 中 。 如 果 和 希望 Android 应 用 程序 实现 多 任务 ,可 以 通过 代码 指定 组 件 运行 
在 其 他 进程 里 ,或 为 进程 创建 额外 的 线程 。 

Android 线程 之 间 和 进程 之 间 是 不 能 直接 传递 消息 的 ,必须 通过 对 消息 队列 和 消息 
循环 的 操作 来 完成 。Android 消息 循环 是 针对 线程 的 ,每 个 线程 都 可 以 有 自己 的 消息 队 
列 和 消息 循环 。Android 提供 了 Handler 类 和 Looper 类 来 来 访问 消息 队列 Message 
Queue。Android 有 两 种 方式 实现 多 线程 操作 UI: 第 一 种 是 创建 新 线程 Thread, 用 
Handler 负责 线程 间 的 通信 和 消息 ;第 二 种 方式 AsyncTask 异步 执行 任务 。 

Service 是 Android 的 四 大 组 件 之 一 ,用 于 支持 Android 系统 的 服务 。Service 不 能 与 
用 户 交互 ,也 不 能 自己 启动 ,需要 调用 Context. startService( ) 或 Context. bindService() 
来 启动 ,在 后 台 运 行 。Android 的 其 他 应 用 的 组 件 可 以 在 后 台 启 动 一 个 Service 运行 , 即 
使 用 户 切 换 到 另 一 个 应 用 此 Service 也 会 继续 运行 。 无 论 使 用 哪 一 种 方式 启动 ,还 是 同时 
使 用 这 两 种 方式 获得 服务 ,都 需要 使 用 Intent。 
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任何 应 用 程序 都 可 以 通过 文件 系统 存储 文件 ,其 他 应 用 程序 可 以 来 读 取 这 些 文件 ， 
当然 ,这 可 能 需要 访问 权限 的 设置 。Android 提供 几 种 持久 化 应 用 程序 数据 的 选择 , 具 
体 选择 哪 种 方式 依赖 于 具体 的 需求 ,例如 数据 应 该 是 应 用 程序 私有 的 还 是 共享 的 ,或 
者 数据 所 需要 的 存储 空间 等 ,其 中 可 选择 的 数据 存储 方案 包括 : 共享 偏好 使 用 键 值 对 
的 形式 保存 私有 的 原始 数据 ;内 部 存储 用 来 在 设备 的 内 部 存储 介质 上 保存 私有 的 数 
据 , 一 般 固化 在 设备 里 的 ;扩展 存储 用 来 在 共享 的 外 部 存储 介质 上 保存 公共 的 数据 ,是 
可 移动 的 ;SQLite 用 来 保存 结构 化 的 数据 ,而 且 是 私有 的 ;网 络 连接 是 把 数据 保存 在 自 
己 的 互联 网 服务 器 上 。 

在 Android 中 ,应 用 程序 的 所 有 数据 对 其 他 应 用 程序 都 是 私有 的 ,其 他 应 用 只 有 通过 
设置 权限 才 可 以 获取 数据 。Android 系统 提供 了 几 种 本 地 数据 的 存储 方式 ,如 果 要 将 这 
些 数据 共享 的 话 ,Android 通过 定义 内 容 提 供 器 (Content Provider) ,能 够 把 私有 数据 共 
享 给 其 他 应 用 程序 。 内 容 提供 器 是 一 种 为 了 开放 应 用 程序 的 数据 读 写 , 具 有 访问 权限 的 
可 选 组 件 , 可 以 通过 这 个 组 件 实现 私有 数据 的 读 写 访问 。 内 容 提供 器 提供 了 请 求 和 修改 
数据 的 标准 语法 和 读 取 返回 数据 的 标准 机 制 。Android 为 标准 的 数据 类 型 提供 了 一 些 内 
容 提 供 器 ,如 图 像 、 视 频 和 音频 文件 ,以 及 个 人 通讯 录 信息 。 


7.1 本 地 数据 存储 


Android 提供 几 种 保存 持久 化 应 用 程序 数据 的 选择 。 依 赖 具 体 的 需求 来 选择 解决 适 
合 的 方案 ,如 数据 应 该 是 应 用 程序 私有 的 还 是 共享 的 ,以 及 数据 所 需要 的 存储 空间 等 。 

Android 的 应 用 程序 可 以 选择 的 数据 存储 方式 包括 以 下 几 种 。 

。 共享 偏好 (Shared Preferences) : 用 键 值 对 的 形式 保存 私有 的 原始 数据 。 

。 内 部 存储 (Internal Storage) : 在 设备 的 内 部 存储 上 保存 私有 的 数据 ,这 是 内 置 在 
设备 中 ,不 可 以 任意 移 除 的 存储 。 
外 部 存储 (External Storage) : 在 共享 的 外 部 存储 器 上 保存 公共 的 数据 ,这 是 扩充 
的 存储 ,可 以 任意 移 除 。 
SQLite 数据 库 : 在 私有 的 数据 库 中 保存 结构 化 的 数据 。 
网 络 连接 (Network Connection) : 把 数据 保存 在 自己 的 互联 网 服务 器 上 ,例如 云 
存储 。 本 节 主 要 介绍 本 地 数据 的 存储 ,所 以 这 部 分 暂时 不 包括 。 
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7.2 共享 偏好 的 存 取 与 设置 


当 应 用 程序 需要 保存 配置 偏好 时 ,不 同 软件 系统 都 有 对 应 的 解决 方法 。 例 如 
Microsoft Windows 系统 通常 采用 ini 文件 进行 保存 ;J2EE 应 用 采用 properties 属性 文件 
或 者 XML 文件 进行 保存 。 

Android 采 提供 了 一 种 叫 共享 偏好 的 存储 方式 。 共 享 偏好 存储 方式 类 似 Windows 
系统 上 的 ini 配置 文件 ,不 同 之 处 是 它 分 为 多 种 权限 ,可 以 全 局 共享 访问 。 共 享 偏好 方式 
主要 用 于 保存 一 些 常用 的 配置 ,如 窗口 状态 。 例 如 ,可 以 通过 它 保 存 上 一 次 用 户 所 做 的 修 
改 或 者 自 定义 参数 设 定 , 当 再 次 启动 程序 后 依然 保持 原 有 设置 。 

应 用 程序 通常 包括 允许 用 户 修改 应 用 程序 的 特性 和 行为 的 设置 功能 。 例 如 ,一 些 应 用 
程序 允许 用 户 指定 通知 是 否 启用 或 指定 多 久 使 用 云 同步 数据 。 如 果 要 为 应 用 程序 提供 设置 
共享 偏好 的 功能 ( 见 图 7. 1) ,需要 使 用 Android 的 Preference API 来 构建 统一 的 接口 。 
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图 7.1 使 用 Perference API 创建 的 配置 界面 


721 存 取 共 享 偏好 


共享 偏好 SharedPreference 是 一 种 轻 量 级 机 制 ,其 使 用 键 值 对 能 够 保存 任意 类 型 的 
原始 类 型 数据 : 布尔 型 、 浮 点 型 .整数 型 ,以 及 字符 串 。 存 储 的 时 候 类 似 于 Map 的 key- 
Value 值 对 。 

共享 偏好 是 采用 XML 格式 将 数据 存储 到 设备 中 .路径 为 data/data/ 包 名 /share_ 
prefs/ 文 件 名 . xml。 共 享 偏好 处 理 数 据 有 3 种 模式 : 

(1) MODE_PRIVATE 表示 只 有 创建 这 个 SharedPreferences 的 程序 ,才能 访问 这 个 
SharedPreferences。 这 是 默认 的 模式 。 

(2) MODE_WORLD_READABLE 表示 其 他 程序 对 这 个 SharedPreferences 只 有 只 
读 权 限 。 
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(3) MODE_WORLD_WRITEABLE 则 是 其 他 程序 同时 拥有 读 写 权 限 。 

如 果 在 应 用 程序 中 要 获取 一 个 SharedPreferences 对 象 ,有 两 个 方法 : 

(1) Context. getSharedPreferences (String name,int mode) ,name 为 本 组 件 的 配置 
文件 名 ,mode 为 操作 模式 ,默认 的 模式 为 0 或 MODE_PRIVATE。 

(2) Activity. getPreferences(int mode) ,这 个 方法 由 于 没有 配置 文件 名 ,配置 文件 仅 
可 以 被 调用 的 Activity 使 用 。 

获取 SharedPreferences 对 象 后 ,就 可 以 对 其 进行 读 写 。 

如 果 要 读 取 共享 偏好 中 的 文件 信息 ,只 需要 针对 文件 中 所 存储 的 数据 类 型 ,直接 使 用 
Shared Preferences 对 象 的 getX X X () 方 法 ,例如 getString() 、getInt() 或 getBoolean() 
方法 ,根据 键 值 对 读 出 数据 。 

如 果 要 向 共享 偏好 文件 中 写 和 人 信息, 则 必须 先 调用 SharedPreferences 对 象 的 edit() 
方法 获取 一 个 SharedPreferences. Editor 对 象 ,使 其 处 于 可 编辑 状态 ,然后 调用 Editor 对 
象 的 putx X XO 〇 方法 向 文件 中 按键 值 对 的 方式 写 和 数据 ,最 后 调用 commit() 方 法 提交 
更 改 后 的 配置 文件 。 

下 面 是 一 个 简单 的 例子 ,设置 当前 的 Activity 按键 静音 模式 。 其 采用 了 Map 数据 结 
构 来 存储 数据 ,以 键 值 的 方式 存储 ,可 以 简单 地 读 取 与 写 入 , 见 代码 7. 1。 

代码 7.1 Calc. java 


Public class Calc extends Activity { 
Public static final String EREFS NAME= "MyPrefsFile"; 


@ Override 
Protected void onCreate (Bundle state) { 
Super .onCreate (state); 


//Restore preferenoes 
SharedPreferences settings= getSharedPreferences (PREFS NAME, 0); 
boolean silent= settings.getBoolean ("silentMode", false); 
setSilent (silent); 

} 


@ override 
Protected void onStop() { 
Super.onStop(); 


/RE need an Fditor cbject to make Preference changes 

//AL cbjects are from android.omtext.Context 
SharedPreferences settings= getSharedPreferences (PREFS NAME, 0); 
SharedPreferenoes.FEditor editor= settings.edit (); 
editor.putBoolean ("si ", mSilentMpde) 
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数据 读 取 与 写 入 的 方法 都 非常 简单 ,只 是 在 写 入 的 时 候 需 要 先 调 用 edit() 获取 
SharedPreferences. Editor 对 象 , 然 后 使 用 这 个 对 象 写 人 数据 ,最 后 使 用 commit() 提 交 。 
SharedPreferences 是 采用 了 XML 格式 将 数据 存储 到 设备 中 ,在 DDMS 中 File Explorer 
的 /data/data/ 一 package name 二 /shares_prefs 下。 

使 用 SharedPreferences 是 有 些 限制 的 : 只 能 在 同一 个 包 内 使 用 ,不 能 在 不 同 的 包 之 
间 使 用 。 


722 理解 Feference 框架 


当 开 发 移动 应 用 时 ,通常 需要 存储 用 户 的 偏好 参数 ,并 且 在 应 用 程序 运行 时 使 用 这 些 
参数 。 由 于 这 是 一 个 经 常 性 的 应 用 模式 ,Google 创建 了 一 个 偏好 框架 ,提供 一 种 机 人 制 使 
开发 者 能 够 很 容易 地 显示 ,保存 和 操作 用 户 的 偏好 。 使 用 该 框架 ,在 XML 文件 中 就 可 以 
定义 丰富 的 用 户 界面 。 可 以 称 这 些 界面 为 设置 ,用 来 帮助 用 户 选 择 自己 的 偏好 。 

前 面 章 节 中 讲述 的 界面 控件 大 多 是 View 类 的 子 类 ,而 设置 界面 是 由 偏好 对 象 构建 
的 ,都 是 Preference 的 子 类 。 与 View 类 界面 控件 类 似 ,通过 XML 文件 定义 不 同类 型 的 
偏好 对 象 。 一 个 偏好 设置 界面 由 一 个 或 多 个 偏好 对 象 组 成 。 每 个 偏好 对 象 就 是 设置 界面 
上 一 个 项 目 , 为 用 户 提供 合适 界面 改变 偏好 设置 ,例如 CheckBoxPreference 对 象 是 复 选 
框 类 型 的 设置 界面 ;而 ListPreference 提供 了 一 个 单 选 的 模 态 窗 体 。 每 一 个 偏好 都 以 键 
值 对 的 形式 保存 在 应 用 程序 默认 的 SharedPreferences 文件 中 。 当 用 户 改变 设置 时 ,系统 
会 更 新 SharedPreferences 文件 中 对 应 的 值 。 读 取 SharedPreferences 文件 中 数据 ,可 以 
根据 用 户 的 共享 参数 改变 应 用 程序 的 行为 。 

1. 使 用 XML 文件 定义 偏好 设置 界面 

新 的 偏好 对 象 可 以 在 运行 时 实例 化 ,也 可 以 在 XML 中 用 偏好 层级 对 象 来 定义 。 使 
用 XML 定义 设置 是 首选 ,因为 XML 文件 结构 是 更 容易 阅读 的 ,更 新 也 很 简单 ,并且 可 以 
在 运行 时 修改 它们 。 每 一 个 偏好 子 类 都 能 使 用 XML 节点 来 匹配 声明 。Android 系统 预 
定义 了 一 些 偏好 选项 ,下 面 列 出 一 些 主要 的 选项 。 

(1) CheckBoxPreference 是 一 个 带 有 复 选 框 的 偏好 项 目 , 可 以 用 来 设置 打开 和 关闭 
两 种 状态 ,其 在 SharedPreferences 文件 中 保存 的 值 为 boolean 类 型 ,true 表示 是 打开 。 

(2) ListPreference 是 一 个 带 有 单 选 按钮 的 偏好 选项 ,其 单 选项 列表 会 在 一 个 模 态 窗 
体 中 显示 ,保存 的 值 支持 任何 类 型 。 

(3) EditTextPreference 是 一 个 带 有 文本 编辑 框 的 偏好 选项 ,其 保存 的 值 为 String 
类 型 。 

(4) RingtonePreference 用 户 使 用 这 个 偏好 选项 从 设备 上 选择 铃声 ,选中 的 铃声 URI 
会 被 保存 为 String 类 型 。 


oe 基于 hdroid 平 台 的 移动 互联 网 开发 


设计 SharedPreferences 设置 界面 的 XML 文件 需要 保存 在 项 目的 res/xml 目录 下 ， 
其 文件 名 可 以 任意 命名 ,但 一 般 都 使 用 preferences. xml 作为 偏好 的 文件 名 。 如 果 要 为 偏 
好 设置 创建 多 面板 布局 , 则 需要 为 每 一 个 Fragment 创建 单独 的 XML 文件 。 

在 偏好 设置 界面 的 XML 文件 中 , 根 节点 必须 是 一 个 二 PreferenceScreen 二 元 素 , 在 
这 个 元 素 中 可 以 定义 多 个 偏好 对 象 。 在 二 PreferenceScreen 之 中 添加 的 每 个 子 元 素 代 表 
了 偏好 设置 列表 中 的 一 个 项 目 ,代码 7. 2 是 一 个 XML 定义 偏好 设置 的 示例 代码 。 

代码 7.2 preferences. xml 
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在 代码 7.2 中 使 用 了 CheckBoxPreference、ListPreference 和 EditTextPrefence 三 种 
偏好 项 目 , 并 使 用 PreferenceCategory 对 偏好 项 目 进行 分 组 。 其 中 包含 的 一 些 属性 解释 
如 下 。 

(1) android:key: 当 需 要 保存 偏好 项 目的 值 时 ,这 个 属性 是 必需 的 。 这 个 属性 为 每 
个 偏好 对 象 指定 了 唯一 的 key( 一 个 字符 串 类 型 ), 当 系统 在 SharedPreferences 文件 中 保 
存 偏好 设置 时 ,需要 用 到 这 个 属性 。 

(2) android:title: 为 偏好 设置 提供 了 一 个 用 户 可 见 的 名 称 。 

(3) android: defaultValue: 这 指定 初始 值 , Android 系统 将 其 保存 在 Shared- 
Preferences 文件 中 。 

应 用 程序 中 的 偏好 设置 可 能 定义 了 一 些 影 响 用 户 操作 的 重要 行为 ,所 以 当 用 户 第 一 
次 打开 应 用 程序 时 ,有 必要 为 每 一 个 偏好 设置 项 目 在 SharedPreferences 文件 中 赋予 初始 
化 默认 值 。 要 实现 这 个 功能 ,首先 ,必须 在 XML 文件 中 为 每 一 个 偏好 项 目 指定 一 个 默认 
值 ( 见 代 码 7.3) 。 

代码 7.3 为 偏好 项 目 指定 默认 值 


< CheckBoxPreferenoe 
android:defaultValue= "true" 
/> 


<IistPreference 
android:defaultValue= "@ string/pref syncConnecticnTyPes default" 
[> 


然后 ,在 Activity 的 onCreate() 方 法 中 调用 setDefaultValues() 方 法 ,代码 如 下 : 
PreferenceManager.setDefaultValues (this, R.xml .advanoed preferenoes, false); 


在 onCreate() 方 法 中 ,调用 setDefaultValues() 方 法 的 目的 是 为 了 在 应 用 程序 启动 的 
时 候 使 用 默认 设置 初始 化 。 这 个 方法 中 有 三 个 参数 ,第 一 个 参数 为 应 用 程序 的 Context; 
第 二 个 为 偏好 设置 XML 文件 的 资源 ID; 第 三 个 boolean 值 表 示 是 否 多 次 设置 默认 值 , 当 
然 大 部 分 情况 下 默认 值 一 般 只 需要 设置 一 次 , 值 为 false 即 可 。 

(1) android:summary: 为 偏好 设置 选项 提供 一 个 用 户 可 见 的 摘要 。 

(2) android:entries: 这 个 选项 只 在 ListPreference 中 使 用 ,用 来 定义 单 选 窗口 中 的 
显示 项 目 。 它 引用 了 一 个 数组 资源 @array/updateInterval( 见 代码 7. 4)。 

代码 7.4 定义 单 选 窗口 的 中 的 显示 项 目 


< string- array name= "updateInterval"> 
< item name= "1000"> 1 秒 < /item> 
< item name= "5000"> 2 秒 < /item> 
< item name= "30000"> 30 秒 < /itemz 
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< item name= "60000"> 1 分 钟 < /item> 
< item name= "300000"> 2 分 钟 < /item> 
</stringr array> 


(3) android:entryValues: 这 个 选项 只 在 ListPreference 中 使 用 ,用 来 定义 选项 的 保 
存 值 。 它 引用 了 男 一 个 数组 资源 @ ee 代码 7. 5)。 
代码 7.5 定义 单 选项 的 保存 值 


< string- array name= "updateIntervalValues"> 
< item name= "1000"> 1000< /item> 
< item name= "5000"> 5000< /item> 
< item name= "30000"> 30000< /item> 
< item name= "60000"> 60000< /item> 
< item name= "300000"> 300000< /item> 
< /stringr array> 


为 了 在 Acitivity 中 显示 偏好 设置 ,继承 PreferenceActivity 类 ,基于 偏好 对 象 层级 关 
系 来 显示 一 个 设置 列表 。 当 用 户 做 出 一 个 改变 时 ,PreferenceActivity 能 自动 保存 与 每 一 
个 Preference 相关 的 设置 。 

与 View 类 的 GUI 加 载 不 同 ,在 onCreate() 回 调 方法 中 使 用 addPreferencesFrom- 
Resource() 调 用 来 添加 所 定义 的 SharedPreferences 设置 界面 XML 文件 ( 见 代码 7.6) 。 

代码 7.6 定义 PreferencActivity 子 类 ,引用 偏好 设置 的 XML 文件 


Public class QuickPrefsActivity extends PreferenoeActivity { 


@oOverride 

Public void onCreate (Bundle savedInstanceState) { 
Super.onCreate (savedInstanceState) 7 
addPreferenoesFrarResouroe (R.xml .preferenoes); 


有 


如 果 在 Android 3. 0 或 更 高 版 本 上 开发 , 可 使 用 PreferenceFragment 来 显示 
Preference 对 象 列表 ,因为 PreferenceFragment 提供 比 ee 更 为 灵活 地 应 
用 程序 结构 。 使 用 PreferenceFragment 需要 首先 定义 一 个 设置 子 类 SettingsFragment， 
然后 将 这 个 Fragment 添加 到 Activity 码 中 ( 见 代 码 7.7) 。 

代码 7.7 定义 PreferenceFragment 子 类 .为 Activity 添加 定义 好 的 偏好 设置 


static class SettingsFragment extends PreferenosFragment { 
@ Override 
Public void oncreate (Bundle savedInstanoaState) { 
super.onCreate (savedTInstanceState) ; 
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addPreferencesFrorResource (R.xml .preferenoes); 


public class SettingsRctivity extends Rctivity { 
@ Override 
Protected void onCreate (Bundle savedInstanoeState) { 
Super .onCreate (savedInstanoeState); 
getFragnentManager () .beginTransacticn () 
replace (android.R.id.content，new SettingsFragment ()) 


-Ommit(); 
} 


完成 偏好 设置 界面 的 设计 ,运行 应 用 程序 可 以 到 偏好 设置 的 启动 界面 ( 见 图 7. 2(a))。 
然后 ,选择 “是 否 更 新 ”这 个 偏好 选项 设置 打开 “更 新 间隔 ”设置 界面 ( 见 图 7.2(b)), 可 以 
选择 具体 的 更 新 闻 隔 设置 值 。 这 两 个 设置 界面 之 间 的 依赖 关系 是 一 个 非常 有 用 的 设 定 ， 
在 preferences. xml 文件 使 用 android:dependency 一 "perform_updates" 属 性 来 定义 了 两 
个 项 目的 依赖 关系 ,这 个 属性 值 指向 了 “是 否 更 新 ”项目 。 

选择 “设置 欢迎 信息 ”, 然 后 会 看 到 下 面 的 对 话 框 ,这 是 一 个 带 有 文本 编辑 框 的 偏好 设 
置 项 目 ( 见 图 7. 2(c))。 对 于 这 种 偏好 设置 选项 ,其 界面 上 面 的 显示 信息 也 可 用 通过 
XML 文件 定义 。 在 代码 7. 2 preferences. xml 中 ,使 用 android:dialogMessage 属性 设置 
对 话 框 的 提示 信息 ;使 用 android:dialogTitle 属性 设置 对 话 框 的 标题 。 


更 新 间隔 

1 秒 QO 
-Et 加 
打开 或 者 关闭 数据 更 新 2 秒 [@) 

欢迎 信息 
更 新 间隔 30 秒 i 次 迎 信 
定义 数据 更 新 的 时 间 间 隔 i 
欢迎 信息 1 分 钟 OO 
设置 欢迎 信息 2: 
定义 需要 显示 的 欢迎 信息 分 名 O Hello, Mobile World 
取消 取消 确定 
(a) (b) (0) 


图 7.2 偏好 设置 界面 


默认 的 情况 下 ,所 有 应 用 中 的 偏好 都 会 保存 到 一 个 文件 中 ,调用 静态 方法 
PreferenceManager. getDefaultSharedPreferences( ) 能 够 获得 所 保存 的 偏好 值 ,其 返回 一 
个 SharedPreferences 对 象 , 这 个 对 象 中 包含 所 有 在 PreferenceActivity 中 使 用 的 偏好 对 
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象 的 键 值 对 。 代 码 7. 8 是 从 SharedPreferences 文件 中 读 取 偏好 项 目 值 的 一 个 简单 例子 。 
代码 7.8 从 SharedPreferences 文件 中 读 取 偏好 项 目 值 


SharedPreferences shPr= PreferenoeManager. getDefaultSharedPreferenoes (this); 
String syncConmnPref= shPr-getString (SettingsActivity.KEY PREF SYNC ONN, ™); 


通过 给 偏好 项 目 添加 过 intent 之 元素, 可 以 定义 需要 启动 的 Intent, 打 开 一 个 Activity 
或 启动 一 个 服务 ,例如 打开 浏览 器 来 查看 一 个 Web 页 面 ( 见 代码 7.9) 。 
代码 7.9 为 偏好 项 目 定义 Intent 


< Preference android:title= "@ string/prefs web page"> 
< intent android:action= "android.intent .action.VIEW" 
android:data= "http://www.exanple.om"/> 
< /Preferenoe> 


2. 监听 偏好 项 目的 改变 

在 应 用 程序 运行 过 程 中 ,有 些 情况 下 , 当 SharedPreferences 设置 发 生 改 变 时 ,希望 可 
以 得 到 通知 。 这 个 功能 可 以 使 用 SharedPreference. OnSharedPreferenceChange-Listener 

这 个 接口 来 实现 。 通 过 调用 registerOnSharedPreferenceChangeListener ( ) 方法 为 

SharedPreference 对 象 注 册 监 听 器 。 然 后 覆盖 这 个 接口 的 唯一 回调 方法 
onSharedPreferenceChanged() 。 通 过 实现 这 个 接口 ,可 以 在 任意 一 个 偏好 项 目 发 生 改 变 
时 ,取得 一 个 回调 。 代 码 7. 10 是 一 个 简单 的 例子 。 

代码 7.10 定义 偏好 项 目 改 变 监听 器 


OnSharedPreferenceChangeListener { 
piblic static final String KEY FREE SYNC ONN "pref syncOonnecticrmypeny 


Public void onSharedPreferenceChanged (SharedPreferences 
sharedPreferenoes, String key) { 
if (eyequals(Ey FREE SC CONN)) { 
Preference omnectionPref= findPreferenoe (key); 
// 为 选中 的 值 设置 用 户 描述 摘要 
cmnectionPref .setSumrary (sharedpreferenoes.getString (key, ™)); 


. 


在 代码 7. 10 中 ,onSharedPreferenceChanged() 方 法 会 检测 改变 的 设置 是 否 为 一 个 
已 知 的 preference key。 如 果 是 ,就 会 调用 findPreference() 来 获得 改变 后 的 Preference 
对 象 , 针 对 其 给 出 所 需要 的 处 理 。 这 里 设置 了 一 个 摘要 ,用 于 当 用 户 选 中 时 给 出 提示 信 
息 。 其 实 这 是 一 个 比较 好 的 方法 ,特别 是 多 个 被 选中 时 ,可 以 通过 现 有 的 API 让 用 户 知 
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道 他 们 做 了 些 什么 并 得 到 反馈 。 

要 让 监听 器 起 作用 ,还 需要 在 Activity 声明 周期 的 onPause() 和 onResume() 方 法 中 
注册 和 注销 的 监听 器 , 见 代码 7. 11。 

代码 7.11 注册 和 注销 监听 器 


@ Override 


7.3 ”文件 读 取 与 保存 


在 应 用 程序 保存 文件 有 两 个 目的 。 一 种 目的 只 是 针对 某 种 应 用 使 用 ,不 能 被 其 他 应 
用 使 用 ,其 为 私有 文件 ,例如 电子 阅读 应 用 使 用 的 文件 具有 特殊 的 格式 ,只 能 被 电子 阅读 
应 用 使 用 。 另 外 一 种 目的 不 是 针对 特定 应 用 的 ,可 以 被 其 他 应 用 使 用 ,其 为 公共 文件 , 例 
如 照相 机 产生 的 图 片 文件 ,可 以 被 图 像 编辑 应 用 或 者 其 他 应 用 使 用 。 当 需要 对 文件 操作 
时 ,要 根据 这 两 个 目的 正确 选择 内 部 存储 或 是 外 部 存储 。 一 般 来 说 ,应 用 程序 都 会 使 用 两 
种 文件 夹 ,一 种 是 在 内 部 存储 上 ,用 来 保存 私有 数据 ;还 有 一 种 是 在 扩展 存储 上 ,用 来 保存 
公共 数据 。 

当然 ,应 用 程序 的 私有 数据 也 可 以 保存 扩展 存储 上 。 扩 展 存储 一 般 是 可 移动 的 存储 
介质 ,而 且 缺 少 安全 保护 ,所 以 可 以 用 来 保存 公共 数据 。 移 动 设备 的 内 部 存储 由 生产 厂商 
固化 在 设备 上 ,其 存储 空间 是 受到 限制 的 ,一 般 不 会 很 大 ,而 且 不 能 扩展 。 所 以 需要 考虑 
将 一 些 文件 保存 在 扩展 存储 上 。 具 体 哪 些 文件 保存 在 扩展 存储 上 ,与 文件 的 大 小 和 用 途 
等 多 个 方面 的 因素 有 关 。 


731 内 部 存储 


前 面 学 习 的 SharedPreferences ,主要 存储 数据 类 型 是 键 值 对 ,用 于 存储 简单 的 信息 。 
而 对 于 按 顺 序 读 写 大 数据 ,例如 读 写 镜像 文件 或 基于 网 络 的 数据 交换 ,Android 使 用 的 文 
件 系统 与 其 他 平台 的 基于 磁盘 的 文件 系统 类 似 。 本 节 和 下 一 节 主 要 介绍 如 何 使 用 File 
API 在 Android 的 存储 区 域 中 来 执行 读 写 Android 文件 系统 的 操作 。 

所 有 的 Android 设备 都 有 两 个 文件 存储 区 域 : 内 部 (Internal) 和 外 部 (External) 存 储 
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器 。 这 两 个 名 称 来 自 早期 的 Android, 当 时 大 多 数 设备 都 提供 内 署 的 固定 的 内 存 ( 内 署 存 
储 器 ) ,外 加 一 个 可 移动 的 存储 介质 ,如 micro SD 卡 ( 外 部 存储 器 )。 有 些 设备 把 固定 不 变 
的 存储 空间 分 成 “内 部 ”和 “外 部 ”两 部 分 ,这 样 即 使 没有 可 移动 的 存储 介质 ,也 总 会 有 两 个 
存储 空间 ,并 且 不 管 外 部 存储 器 是 可 移动 的 ,还 是 固定 的 ,API 的 使 用 方法 是 相同 的 。 

Android 的 内 部 存储 器 与 外 部 存储 器 各 自 具有 不 同 的 特点 ,可 以 根据 应 用 程序 的 数 
据 存储 要 求 ,选择 将 文件 存储 到 合适 的 存储 区 域 。 表 7-1 是 它们 的 特点 对 比 。 


表 7-1 内 部 与 外 部 存储 器 比较 


内 部 存储 器 外 部 存储 器 
(1) 始终 可 访问 (1) 并 非 始 终 可 访问 ,因为 用 户 可 能 安装 USB 之 
(2) 默认 情况 下 存储 的 文件 只 能 自己 的 应 用 可 以 类 的 存储 介质 ,有 时 会 印 载 
访问 (2) 是 无 限制 可 读 的 ,因此 存储 的 文件 可 能 会 被 
(3) 要 确保 文件 不 被 其 他 用 户 或 应 用 访问 ,内 部 外 界 应 用 读 取 , 不 可 控制 
存储 是 最 好 的 (3) 当 用 户 务 载 应 用 程序 后 ,系统 也 会 删除 此 应 
用 程序 ,使 用 getExternalFilesDir( ) 保存 的 
文件 
(4) 对 于 希望 与 其 他 应 用 共享 ,不 需要 访问 限制 
的 文件 来 说 ,外 部 存储 是 最 好 的 


内 部 存储 器 (Internal Storage) ,就 是 将 文件 保存 在 设备 内 部 存储 器 中 。 上 默认 情况 下 ， 
这 些 文件 是 相应 程序 私有 的 ,对 其 他 程序 不 透明 ,对 用 户 也 是 不 透明 的 。 当 程序 印 载 后 ， 
这 些 文件 就 会 被 删除 。 在 内 部 存储 器 上 保存 数据 时 ,不 需要 设置 任何 权限 ,应 用 程序 始终 
有 权 读 写 它 在 内 部 存储 器 目录 中 保存 的 文件 。 

Android SDK 提供 的 文件 存储 权限 : 

。 Context. MODE_APPEND: 追加 方式 存储 。 

。 Context. MODE_PRIVATE: 私有 方式 存储 ,其 他 应 用 无 法 访问 。 

。 Context. MODE_WORLD_READABLE: 允许 其 他 应 用 读 取 数据 。 

。 Context. MODE_WORLD_WRITEABLE: 允许 其 他 应 用 写 和 人、 读 取 数据 。 

应 用 程序 的 内 部 存储 目录 是 在 Android 文件 系统 的 特定 位 置 ,是 由 应 用 程序 的 包 
名 称 来 指定 的 。 从 技术 上 来 说 ,如 果 把 该 文件 模式 设置 为 可 读 的 ,那么 另外 一 个 应 用 
程序 是 可 以 读 取 内 部 文件 的 。 但 是 ,其 他 的 应 用 程序 还 需要 知道 应 用 程序 的 包 名 和 文 
件 名 。 其 他 的 应 用 程序 不 能 浏览 应 用 程序 内 部 目录 ,并 且 除 非 把 该 文件 设置 为 可 读 或 
可 写 ,否则 其 他 的 应 用 程序 不 能 够 对 其 进行 读 写 访问 。 因 此 在 内 部 存储 器 上 ,只 要 文 
件 使 用 了 MODE_PRIVATE 模式 ,那么 其 他 的 应 用 程序 就 不 会 访问 到 它们 。 

一 般 来 说 ,作为 应 用 程序 私有 的 文件 需要 保存 在 内 部 存储 上 。 例 如 这 些 文件 可 能 是 
下 载 的 杂志 数据 文件 等 ,将 它们 看 作 是 应 用 程序 的 一 部 分 。 默 认 情 况 下 ,保存 在 内 部 存 
储 上 的 文件 是 应 用 程序 的 私有 数据 ,其 他 应 用 程序 不 能 访问 它们 。 这 些 文件 存放 在 应 用 
程序 的 安装 文件 夹 中 ,并 且 遵守 一 定 的 命名 规则 。 当 用 户 印 载 应 用 程序 时 ,这 些 文件 也 会 
被 删除 ,这 样 符合 Android 数据 的 清理 机 制 。 
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在 内 部 存储 器 中 创建 并 保存 数据 文件 ,可 以 按照 以 下 步骤 来 做 : 

(1) 使 用 FileOutputStream 对 象 ,调用 openFileOutput() 方 法 ,参数 分 别 为 文件 名 、 
操作 模式 ,返回 值 是 一 个 FileOutputStream 。 

(2) 使 用 write() 方 法 向 文件 中 写 和 数据。 

(3) 调用 close() 方 法 ,关闭 输出 流 。 

代码 7.12 使 用 内 部 存储 保存 文件 


String FTIENRMP- "hello file"; 
String string= "hello world!"; 


FileQutputStream fos= cpenFileOutput (FIIFNAME, Context.MOLE PRIVATE); 
fos.write (string.getBytes ())7 
fos.close()7 


openFileOutput 方法 中 的 参数 FILENAME 用 于 指定 文件 名 称 , 不 能 包含 路 径 分 隔 
符 */”, 如 果 文 件 不 存在 ,Android 会 自动 创建 它 。 创 建 的 文件 保存 的 目录 为 ， 


/data/data/< package name> /files/ 


例如 ,/data/data/com. google. sample/files/hello _ file。 /data/data/com. google 
. sample/ 是 应 用 程序 安装 时 自动 产生 的 目录 ,用 来 保存 应 用 程序 的 科 有 数据 。 其 中 files 
是 一 个 子 目 录用 来 保存 文件 ,还 有 可 能 有 databases(SQLite 数据 库 ) shared_prefs( 共 享 
引用 ) cache( 缓 存 的 文件 和 数据 ) 和 lib( 本 地 库 ) 。 

openFileOutput 方法 的 第 二 个 参数 代表 文件 读 写 模式 。 代 码 7. 12 中 , MODE _ 
PRIVATE 表示 要 创建 一 个 新 文件 。 如 果 有 同名 文件 存在 , 则 会 替换 旧 文 件 , 并 且 这 个 文 
件 是 应 用 程序 的 私有 文件 。 其 他 可 用 的 模式 还 包括 : 

(1) MODE_APPEND: 表示 只 有 创建 此 文件 的 程序 能 够 使 用 ,其 他 应 用 程序 不 能 访 
问 。 如 果 目 录 中 有 同名 文件 , 则 在 原 有 内 容 基础 上 增加 数据 。 

(2) MODE_WORLD_READABLE: 表示 可 以 被 其 他 应 用 程序 读 取 。 

(3) MODE_WORLD_WRITEABLE: 表示 可 以 被 其 他 应 用 程序 写 入 。 

这 几 个 文件 读 写 模式 是 Android 定义 的 常数 , 值 均 为 整 型 数字 ,因此 可 以 使 用 “1” 符 
合 将 它们 连接 起 来 ,下 面 的 代码 是 一 个 简单 的 例子 。 


cpenFi leOutput (FTIENAME, 
Context.MDDE_ APPEND| Context: .MOLE, WORID RERDREIE) 7 
这 段 代 码 表示 创建 的 文件 可 以 被 其 他 应 用 程序 读 取 ,而 且 , 如 果 原 来 目录 中 有 同名 的 
文件 , 则 在 原 有 文件 的 基础 上 增加 数据 。 
如 果 从 内 部 存储 中 读 取 一 个 文件 ,需要 调用 openFileInput() 方 法 ,把 要 读 取 的 文件 
名 传递 给 这 个 方法 。 有 具体 步骤 如 下 : 
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(1) 调用 openFileInput ( ) 方 法 ,参数 为 即将 读 取 的 文件 名 ,该 方法 返回 一 个 
FileInputStream 。 

(2) 调用 read() 方 法 读 取 字 节 。 

(3) 调用 close() 方 法 关闭 输入 流 。 

代码 7.13 读 取 内 部 存储 的 文件 


String FTLENRME- "hello file"; 


FileInputStream fis= openFileInput (FTFNAME) ; 
byte[] input— new byte[fis.available()]; 
while (fis.read(input) !=— 1){} 
String str= new String(input); 
fis.close(); 
内 部 存储 中 设置 的 /data/data/ 一 package name 二 /cache 目录 用 于 放置 临时 缓存 文 
件 。 对 于 一 些 只 需 临时 缓存 的 数据 ,可 以 使 用 Content 类 的 getCacheDir( ) 方 法 来 打开 一 
个 File 对 象 , 对 这 个 目录 进行 操作 。 如 果 需 要 自己 创建 缓存 文件 ,可 以 使 用 
createTempFile( ) 方 法 创建 。 例 如 代码 7. 14 中 的 方法 实现 了 简单 的 文件 读 取 和 临时 组 
存 的 功能 ,首先 获取 文件 名 ,然后 将 其 保存 在 内 部 存储 的 缓存 中 。 
代码 7.14 文件 读 取 和 临时 缓存 


public File getTerpFile (Context context, String url) { 
File file; 
try{ 
String fileName= Uri .parse (url) .getLastPathSegment (); 
file=File.createTenpFile (fileName, null, omtext .getCacheDir()); 
catch (IOExcepticn e) { 
//Error while creating file 
上 
retum file; 


} 


当 设备 的 内 部 存储 空间 不 足 的 时 候 ,Android 可 能 会 删除 这 些 缓存 文件 来 回收 存储 
空间 。 但 是 ,最 好 不 要 依赖 系统 来 给 自动 清理 这 些 文件 ,而 是 自己 来 维护 缓存 文件 ,把 存 
储 空间 的 耗费 限定 在 合理 的 范围 内 ,如 1MB。 当 用 户 印 载 应 用 程序 时 ,这 些 文件 会 被 删 
除 。Context 类 还 提供 了 其 他 一 些 操作 目录 和 文件 有 用 的 方法 ,其 中 包括 : 

(1) getFileDir(): 获取 保持 内 部 文件 的 绝对 路 径 , 目录 的 格式 为 /data/data/ 
一 package name> /files; 

(2) getDir() : 在 内 部 存储 空间 中 创建 或 打开 一 个 目录 ; 

(3) deleteFile() : 删除 保存 在 内 部 存储 空间 上 的 文件 ; 
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(4) fileList(): 返回 当前 保存 在 应 用 程序 中 的 文件 数组 列表 。 

为 了 避免 出 现 IOException ,通常 调用 getFreeSpace() 和 getTotalSpace() 方 法 来 分 
别 获取 存储 器 的 当前 剩余 的 空间 和 总 空间 大 小 。 当 然 也 不 是 必须 要 调用 该 方法 , 另 一 种 
方式 是 可 以 在 写 入 文件 的 时 候 捕 获 IOException 异常 来 解决 。 

在 应 用 程序 设计 中 ,注意 调用 delete() 方 法 清理 不 需要 的 文件 。 如 果 文 件 位 于 内 部 
存储 器 上 ,可 以 通过 Context 来 定位 ,调用 deleteFile() 来 删除 该 文件 。 当 用 户外 载 掉 应 
用 程序 时 ,所 有 保存 在 内 部 存储 器 上 的 文件 ,以 及 通过 getExternalFilesDir( ) 方 法 保存 在 
外 部 存储 器 上 的 文件 都 将 被 删除 。 而 通过 getCacheDir() 方 法 生成 的 临时 文件 ,需要 手动 
删除 。 


732 扩展 存储 


每 个 Android 兼容 的 设备 都 支持 共享 的 扩展 存储 器 ,用 于 保存 文件 。 这 个 存储 器 能 
够 是 一 种 可 移动 的 存储 介质 (例如 SD 卡 ); 或 者 是 不 可 移动 的 存储 器 ,被 固化 在 设备 里 ， 
但 是 容量 要 比 内 部 存储 大 的 多 。 保 存在 扩展 存储 上 的 文件 是 完全 共享 的 ,并 且 在 启用 了 
USB 存储 把 文件 传输 到 计算 机 上 时 ,用 户 能 够 修改 这 些 
交 件 。 

如 果 用 户 将 扩展 存储 挂 载 到 计算 机 上 ( 见 图 7. 3) 或 者 
移 除了 这 个 存储 介质 ,那么 手机 设备 将 禁止 使 用 扩展 存储 。 
这 些 保 存在 扩展 存储 器 上 的 文件 没有 安全 方面 的 限制 ,所 
有 的 应 用 程序 都 能 够 读 写 放 在 扩展 存储 器 上 的 文件 ,而 且 


用 户 也 能 够 删除 它们 。 图 7.3 对 扩展 存储 操作 
如 果 要 将 文件 保存 在 扩展 存储 上 ,首先 必须 获得 扩展 时 的 提示 信息 


存储 的 权限 。 要 想 获 得 写 人 外 部 存储 器 的 权利 ,需要 在 
manifest 文件 中 取得 WRITE_EXTERNAL_STORAGE 权限 ,例如 : 


<uUses- Permissicn android:name= "android.pemmi ssicn.WRITE FEXIFRNRL SICRAE"/> 


就 目前 来 说 ,所 有 应 用 程序 都 有 读 取 扩 展 存储 的 权限 ,而 不 需 特别 的 权限 申明 权限 。 
如 果 需 要 特别 申明 对 扩展 存储 的 读 权限 ,可 以 指定 READ_EXTERNAL_STORAGE 权 
限 。 当 指定 了 WRITE_EXTERNAL_STORAGE 权限 ,默认 具有 READ_EXTERNAL_ 
STORAGE 的 权限 。 

对 于 内 部 存储 ,没有 必要 申明 权限 ,因为 应 用 程序 对 其 在 内 部 存储 上 私有 目录 默认 就 
有 读 写 的 权限 。 

在 使 用 扩展 存储 之 前 ,需要 调用 Environment 类 的 getExternalStorageState() 方 法 
来 检查 存储 介质 是 否 可 用 。 存 储 介 质 可 能 被 挂 载 到 计算 机 上 丢失、 只 读 或 者 其 他 状态 
( 见 代码 7. 15) 。 
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代码 7.15 扩展 存储 可 用 性 检查 


boolean mrExternalStoragepvailable= false; 
boolean mExtermalStorageWriteable= false; 
String state= Envirorment .getExtermalStorageState (); 


证 (Environment.MEDIA MIUNTED.equals (state)) { 
//We can read and write the media 
rExternalSstoragsAvailable—nExternalStoragenriteable— true; 
} else if (Environment .MEDIA MOUNIED READ ONLY.equals(state)) { 
/WE can only read the media 
rExtemalSstorageAvailable— true; 
ExternalStorageWriteabler false; 
} else { 
//Samething else is wrong. Tt may be cne of many cther states, but all we need 
//to Know is we can neither read nor write 

这 个 例子 检查 了 外 部 存储 器 是 否 可 用 于 读 和 写 。getExternalStorageState() 方 法 还 
可 以 用 来 检查 其 他 状态 ,例如 存储 介质 是 否 被 共享 (连接 到 一 个 计算 机 上 ) 是否 完全 丢 
失 .是否 被 恶意 的 移 除 等 。 在 应 用 程序 需要 访问 存储 介质 时 ,要 随时 获取 这 些 状 态 , 以 便 
给 用 户 提供 更 多 的 通知 信息 。 

如 果 使 用 API 级 别 8(Froyo Android 2. 2) 或 更 高 的 版 本 ,可 以 使 用 
getExternalFilesDir() 方 法 来 打开 一 个 File 对 象 .获取 保存 文件 的 扩展 存储 目录 。 这 个 方 
法 的 第 一 个 参数 指定 了 所 需 的 子 目 录 类 型 。 如 果 此 目录 类 型 参数 值 为 null 值 , 则 返回 应 
用 程序 在 扩展 存储 中 保存 文件 的 如 下 根 目录 。 


storage/odcard0/Android/data/< package name> /files/ 


一 package_name 二 是 Java 样式 的 包 名 ,例如 com. example. android. app。 这 是 
Android 4.2.2 的 目录 结构 ,不 同 版 本 目录 结构 可 能 不 一 样 。 使 用 Environment 类 中 目 
录 常 量 可 以 避免 格式 不 同 的 问题 ,能 够 很 好 地 来 传递 根 目录 下 子 目 录 的 值 。 例 如 
DIRECTORY_MUSIC 和 DIRECTORY_RINGTONES 常量 分 别 对 应 上 述 文件 根 目录 中 
的 Music 和 RingTones 子 目录 ,代码 如 下 : 

context.getExternalFilesDir Environment.DIRBCTORY PICTURES)， 
albunName) ; 


这 个 方法 会 创建 与 系统 规范 一 致 目录 结构 。 通 过 指定 目录 的 类 型 ,确保 Android 系 


统 的 介质 扫描 器 对 文件 进行 正确 的 分 类 。 当 用 户 的 设备 正在 运行 API 级 别 8 或 更 高 的 
版 本 ,如 果 印 载 了 应 用 程序 ,那么 这 个 目录 和 其 所 有 的 内 容 将 会 被 删除 。 
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如 果 使 用 API 级别 7 或 更 低 的 API 版 本 ,可 以 使 用 getExternalStorageDirectory() 
方法 来 打开 一 个 File 对 象 ,获取 扩展 存储 的 根 目 录 , 代 码 如 下 : 


File file=new File( 
ivironment.getExternalStorageDirectory() ，alburName) 7 


如 果 使 用 这 种 方法 , 当 应 用 印 载 后 这 个 目录 不 会 清除 ,会 在 根 目录 下 留 下 很 多 垃圾 
目录 。 

如 果 保 存 的 文件 不 是 应 用 程序 私有 的 ,在 应 用 程序 被 印 载 时 需要 保留 ,存储 的 位 置 则 
要 放 到 扩展 存储 上 的 公共 目录 中 。 这 些 目录 位 于 外 部 存储 器 的 根 目 录 , 如 Music/、 
Pictures/、Ringtones/ 等 。 

在 API 级 别 8 或 更 高 的 版 本 中 ,可 以 使 用 getExternalStoragePublicDirectory ( ) 方 
法 ,参数 的 传递 与 getExternalFilesDir 方法 类 似 。 对 于 临时 文件 ,可 以 使 用 
getExternalCacheDir() 方 法 来 打开 一 个 File 对 象 , 则 在 扩展 存储 目录 中 保存 缓存 文件 。 
如 果 钾 载 应 用 程序 ,这 些 文件 会 自动 地 被 删除 。 但 是 ,在 应 用 的 生存 期 间 , 应 该 自己 管理 
这 些 缓存 文件 ,不 需要 的 时 候 删除 这 些 缓 存 文 件 。 绥 存 数据 被 写 人 下 列 目录 中 : 


storage/odcard0/Android/data/< package name> /cache/ 


733 文件 资源 


Android 系统 可 以 定义 三 种 作为 资源 的 文件 ,它们 分 别 保 存在 三 个 不 同 资源 目录 中 ， 
分 别 为 /res/xml、/res/raw 和 /assets。 

发 布 应 用 时 ,如 果 要 把 一 个 静态 文件 保存 到 应 用 程序 的 发 布 包 中 ,就 要 把 这 个 文件 保 
存在 项 目的 res/raw/ 目 录 中 。 使 用 openRawResource() 方 法 可 以 打开 res/raw/ 目 录 中 
的 静态 文件 , 这 个 方法 需要 把 R. raw. 二 fiename 二 的 资源 ID 传递 给 它 。 
openRawResource() 方 法 会 返回 一 个 用 于 读 取 文 件 的 InputStream 对 象 ,但 是 不 能 对 这 
个 文件 进行 写 和 人 的 操作 。 

/res/xml 资源 目录 可 以 用 来 存储 XML 格式 的 文件 ,并 且 和 其 他 资源 文件 一 样 ,这 里 
的 资源 是 会 被 编译 成 二 进 制 格式 放 到 最 终 的 安装 包 里 的 ,通过 R 类 能 够 访问 XML 文件 
的 资源 ID, 并 且 解 析 里 面 的 内 容 。 例 如 ,/res/xml 里 存放 了 一 个 名 为 data. xml 的 文件 
( 见 代码 7. 16) 。 

代码 7.16 data. xml 


< Zaml versior= "1 .0" encoding= "utf- 8"2> 
<book> 

<title> 移 动 电子 商务 < /title> 
< /book> 


然后 ,就 可 以 通过 资源 ID 来 访问 并 解析 这 个 文件 ( 见 代码 7. 17) 。 
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代码 7.17 使 用 PULL 的 方法 解析 XML 文件 


在 代码 7. 17 中 ,使 用 Resources 类 的 getXml() 方 法 返回 了 一 个 XML 文件 的 PULL 
解析 器 。/res/xml 的 XML 文件 会 被 编译 成 二 进 制 形式 的 。 如 果 想 让 文件 原样 存储 必须 
将 其 存储 到 /res/raw 资源 子 目 录 中 ,这 个 目录 可 以 原封 不 动 地 将 文件 存储 到 设备 上 ,不 
会 被 编译 为 二 进 制 形式 ,访问 的 方式 也 是 通过 R 类 获得 资源 ID。 

修改 代码 7. 17 中 的 第 一 句 , 使 用 openRawResource() 方 法 获取 资源 ( 见 代码 7. 18)。 

代码 7.18 使 用 openRawResource() 方 法 获取 raw 资源 


代码 7. 18 使 用 Resource 类 中 的 openRawResource 方法 ,返回 一 个 输入 流 。 通 过 对 
输入 流 的 操作 ,就 可 以 任意 读 取 文 件 中 的 内 容 。 
如 果 需 要 更 高 的 自由 度 , 尽 量 不 受 Android 系统 的 约 东 ,那么 可 以 选择 使 用 /assets 
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资源 子 目 录 。 这 个 目录 中 的 文件 除了 不 会 被 编译 成 二 进 制 形式 之 外 ,另外 一 点 就 是 访问 
方式 是 通过 文件 名 ,而 不 是 资源 ID, 并 且 还 有 更 重要 的 一 点 就 是 ,大 家 可 以 在 这 里 任意 的 
建立 子 目录 ,而 /res 目录 中 的 资源 文件 是 不 能 自行 建立 子 目录 的 。 

修改 代码 7. 19 中 的 第 一 行 ,使 用 这 种 灵活 的 资源 存储 方式 实现 相同 的 功能 ( 见 代码 
7 19), 

代码 7.19 访问 /assets 文件 资源 


XmlPullParser xml= Ximl .newPullParser (); 
AssetManager asset= getAssets (); 

InputStream in= asset .open ("data.xml"); 

ml .setInput (new StringReader (in.tostring())); 


在 代码 7. 19 中 ,使 用 Context 类 的 getAssets 方法 ,返回 一 个 AssetManager 对 象 ; 然 
后 使 用 open() 方 法 就 可 以 访问 需要 的 资源 ,这 里 open() 方 法 是 打开 assets 目录 中 的 文 
件 ,这 是 Android 项 目的 根 目录 。 所 以 上 面 这 段 代 码 访问 的 是 assets 目录 中 名 为 data 
.xml 文件 资源 。 


7.4 存 取 结构 化 数据 


Android 中 通过 SQLite 数据 库 引 擎 来 实现 结构 化 数据 存储 。Android 系统 提供 了 
对 SQLite 数据 的 完全 支持 ,目前 支持 的 版 本 为 SQLite3 。 

Android 系统 通过 SQLiteDatabase 类 来 对 SQLite 数据 库 进 行 访问 ,该 类 封装 了 一 
些 操作 数据 库 的 API, 使 用 该 类 可 以 完成 对 SQLite 中 数据 进行 添加 (Create) 查询 
(Retrieve) 更 新 (Update) 和 删除 (Delete) 操 作 。 


741 SaQuite 简介 


SQLite 是 一 款 开源 的 、 轻 量 级 的 .嵌入 式 的 .关系 型 数据 库 。 它 是 2000 年 由 D. Richard 
Hipp 发 布 的 ,可 以 支援 Java、Net、.PHP、Ruby、Python、Perl\C 等 几乎 所 有 的 现代 编程 语 
,支持 Windows、Linux、UNIX、Mac OS、Android.、iOS 等 几乎 所 有 的 主流 操作 系统 平 
。 目 前 发 布 的 版 本 是 SQLite 3. 7. 17 ,简称 SQLite3。 

SQLite 是 一 个 嵌入 式 SQL 数据 库 引 擎 ,实现 了 一 个 自 包含 的 ,无 服务 器 、 零 配置 . 事 
务 性 的 SQL 数据 库 ,能 够 针对 内 存 等 资源 有 限 的 设备 (如 手机 .PDA、MP3) 提 供 的 一 种 
高 效 的 数据 库 引 擎 。 就 目前 来 说 ,SQLite 是 世界 上 部 署 最 广泛 的 SQL 数据 库 引 擎 。 

SQLite 具有 以 下 特点 : 

。 事务 处 理 是 原子 的 一 致 的 ,独立 的 和 持久 的 (ACID)。 
。 零 配 置 , 即 不 需要 设置 和 管理 。 
实现 了 绝 大 部 分 的 SQL 92 标准 。 
一 个 单独 的 跨 平台 的 磁盘 文件 存储 一 个 完整 的 数据 库 。 
支持 TB 大 小 数据 库 .G 级 别 的 串 和 二 进 制 大 对 象 。 
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小 于 500KB 的 代码 运行 代码 空间 。 
对 于 绝 大 多 数 普通 操作 来 说 , 比 流行 的 C/S 模式 的 数据 库 引 擎 运行 速度 快 。 
API 简单 . 易 用 。 
自 包 含 : 没有 外 部 依赖 性 。 
跨 平 台 , 支 持 UNIX (Linux、Mac OS-X、Android、iOS) 和 Windows (Win32、 
WinCE、WinRT) 。 

SQLite 与 大 多 数 其 他 SQL 数据 库 不 同 ,SQLite 没有 独立 的 服务 器 进程 ,而 是 直接 
对 普通 的 磁盘 文件 进行 读 取 和 写 人 。 一 个 包含 多 个 表 、 索 引 、 和 触发 器 和 视图 的 完整 
SQLite 数据 库 , 全 包含 在 一 个 单一 的 磁盘 文件 中 。 其 数据 库 文件 的 格式 是 跨 平台 的 ,可 
以 在 32 位 和 64 位 系统 之 间或 big-endian 和 little-endian 体系 结构 之 间 进 行 任意 复制 。 
SQLite 的 这 些 特 点 使 其 成 为 应 用 文件 格式 的 一 个 普遍 选择 。 

SQLite 由 以 下 几 个 组 件 组 成 : SQL 编译 器 、 内 核 , 后 端 以 及 附件 ( 见 图 7. 4)。 
SQLite 通过 利用 虚拟 机 和 虚拟 数据 库 引擎 (VDBE) ,使 调试 .修改 和 扩展 SQLite 的 内 核 
变 得 更 加 方便 。 
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图 7.4 SQLite 数据 库 的 结构 


SQLite3 采用 动态 类 型 ,支持 5 种 存储 的 数据 类 型 ,包括 空 值 (NULL)、 整 型 
(INTEGER) 、 浮 点 数 (REAL) ,字符 串 (TEXT) 和 大 数据 (BLOB) 数 据 类 型 。 虽 然 它 支持 
的 类 型 只 有 5 种 ,但 也 能 够 接收 VARCHAR(n)、CHAR(n)、DECIMAL(p,s) 等 数据 类 
型 的 数据 ,只 是 在 运算 或 保存 时 会 转 成 对 应 的 5 种 数据 类 型 。 

在 SQLite3 中 并 没有 设 定 BOOLEAN 和 DATE 类 型 ,BOOLEAN 型 的 数据 使 用 
INTEGER 的 0 和 1 代替 true 和 false 来 表达 , DATE 类 型 使 用 特定 格式 的 TEXT、 
REAL 和 INTEGER 的 值 来 代替 显示 。 为 了 方便 DATE 类 型 的 操作 ,SQLite 提供 了 一 
组 函数 ,详细 的 使 用 说 明 可 以 参见 http://www. sqlite. org/lang_datefunc. html。 这 样 简 
单 的 数据 类 型 设计 更 加 符合 说 入 式 设备 的 要 求 。 
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SQLite3 的 动态 类 型 特点 ,不 会 强制 数据 类 型 约束 ,任何 类 型 的 数据 可 以 保存 到 任何 
字段 中 ,无 论 这 列 声明 的 数据 类 型 是 什么 。 例 如 ,可 以 在 INTEGER 字段 中 存放 字符 串 ， 
或 者 在 布尔 型 字段 中 存放 浮 点 数 ,或 者 在 字符 型 字段 中 存放 日 期 型 值 。 但 有 一 种 情况 例 
外 ,定义 为 INTEGER PRIMARY KEY 的 字段 只 能 存储 64 位 整数 , 当 向 这 种 字段 中 保 
存 除 整 数 以 外 的 数据 时 ,将 会 产生 错误 。 

SQLite 遵守 标准 SQL 语句 ,常用 的 SQL 语句 语法 如 下 。 

(1) 查询 语句 : 


SETIPCT * FROM 表 名 HEFE 条 件 表达 式 GEOUP BY 分 组 字句 HRVING … CRIER BY 排序 子 句 
(2) 搬入 语句 : 

INSERT INIO 表 名 合 段 列表 ) VanES ( 值 列表 ) 

(3) 更 新 语句 : 

UPDATE 表 名 SET 字段 = 表达 式 [, 字段 = 表达 式 …] WERE 条 件 表达 式 

(4) 删除 语句 : 

TDETETE FROM 表 名 WHERE 条 件 表达 式 


值得 注意 的 是 ,SQLite 不 支持 一 些 标 准 的 SQL 功能 ,特别 是 外 键 约束 (FOREIGN 
KEY constrains) , 骨 套 事务 处 理 和 RIGHT OUTER JOIN 和 FULL OUTER JOIN ,还 有 
一 些 ALTER TABLE 功能 。 

SQLite 是 一 个 紧缩 库 。 如 果 具 有 所 有 的 功能 ,依赖 目标 平台 和 编译 优化 的 设置 , 库 
的 大 小 可 以 不 超过 500KB,64 位 的 可 能 会 大 一 些 。 如 果 可 选 的 一 些 功能 省 略 ,SQLite 大 
小 可 以 低 于 300KB。SQLite 可 以 运行 于 最 小 栈 空间 4KB 和 堆 空 间 100KB 的 环境 中 ,这 
一 优势 ,使 SQLite 在 内 存 受 限 的 嵌入 式 领域 得 到 广泛 应 用 。Android 也 直接 采用 了 
SQLite 数据 库 作为 结构 化 存储 结构 。 

Android 系统 为 SQLite 数据 库 的 操作 提供 了 android. database. sqlite 包 , 用 于 进行 
SQLite 数据 库 的 添加 删除、 修改 和 查询 操作 ,对 应 用 中 所 创建 结构 化 数据 操作 提供 
API, 包 括 SQLiteDataBase 和 SQLiteOpenHelper 等 类 。Android 系统 还 提供 了 关系 数 
据 库 的 管理 功能 ,作为 支持 SQLite 数据 库 系 统 的 一 部 分 ,通过 这 些 功 能 可 以 存 取 其 中 的 
复杂 数据 集 。SQLite 的 数据 库 文件 存储 的 目录 为 /data/ data/package_name/databases。 
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默认 情况 下 ,Android 系统 下 的 SQLite 不 具有 创建 和 管理 数据 库 的 管理 接口 或 应 
用 ,因此 需要 通过 编码 来 创建 数据 库 。 首 先 需要 创建 一 个 SQLiteOpenHelper 类 的 子 类 
来 处 理 数据 库 所 有 的 操作 ,例如 创建 数据 库 、 创 建 表 、 插 入 和 删除 记录 等 。 

SQLiteOpenHelper 提供 如 下 两 个 方法 来 操作 数据 库 

(1) onCreate(SQLiteDatabase db) : 创建 数据 库 时 执行 ,可 以 在 其 中 执行 创建 表 、 字 
段 .视图 和 触发 器 等 。 
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(2) onUpgrade(SQLiteDatabse db ，int oldVersion ，int newVersion) : 当 数 据 库 需 
要 更 新 时 执行 ,需要 实现 更 新 版 本 时 表 的 修改 、 删 除 、 创 建新 等 操作 。 

onUpgrade() 方 法 在 数据 库 的 版 本 发 生变 化 时 会 被 调用 ,数据 库 的 版 本 是 由 程序 员 
控制 的 ,假设 数据 库 现在 的 版 本 是 1.0, 由 于 业务 的 需要 ,修改 了 数据 库 表 的 结构 ,这 时 候 
就 需要 升级 软件 ,升级 软件 时 希望 更 新 用 户 手 机 里 的 数据 库 表 结构 ,为 了 实现 这 一 目的 ， 
可 以 把 原来 的 数据 库 版 本 设置 为 Version2, 并 且 在 onUpgrade() 方 法 中 实现 表 结 构 的 更 
新 。 当 软件 的 版 本 升级 次 数 比较 多 ,这 时 在 onUpgrade() 方 法 中 可 以 根据 原版 号 和 目标 
版 本 号 进行 判断 ,然后 作出 相应 的 表 结 构 及 数据 更 新 。onUpgrade() 在 每 次 成 功 打开 数 
据 库 后 首先 被 执行 ,默认 情况 下 此 方法 的 实现 为 空 。 

在 创建 SQLiteOpenHelper 类 的 子 类 时 ,需要 通过 super (context, name, cursor- 
Factory ,version) ;调用 SQLiteOpenHelper 的 构造 方法 。 其 中 参数 context 是 需要 附加 
到 数据 库 的 数据 ,name 是 数据 库 的 名 称 ,cursorFactory 是 Cursor 的 一 个 子 类 对 象 ,用 于 
查询 ,可 以 是 空 ,version 指数 据 库 的 版 本 。 代 码 7. 20 是 定义 对 SQLite 数据 库 操作 的 
SQLiteOpenHelper 子 类 的 模式 。 

代码 7.20 SQLiteOpenHelper 的 子 类 定义 模式 


Public class DatabaseHelper extends SQLiteopenHelper { 
DatabaseHelper (Context context，String nare, OrsorFactory oursorFactory, int versicn) { 
super (ontext, name, cursorFactory, version); 
/mopo sqLiteopenHelper 构造 方法 
} 


@ Override 

Public void onCreate (SQLiteDatabase db) { 
//mopo 创建 数据 库 ,对 数据 库 的 操作 

} 


@ Override 

Piblic void ntporade (SoLiteDatabase db, int oldVersion, int newWersicn) { 
//mopo 更 新 数据 库 的 操作 

} 


@ Override 

Piblic void onopen (SQLiteDatabase db) { 
Super.anopen (db); 
/mopo 每 次 成 功 打 开 数 据 库 后 首先 被 执行 


下 面 在 Android 系统 中 创建 一 个 简单 的 数据 库 应 用 ,用 来 说 明 如 何 创建 、 操 作 
SQLite 数据 库 。 存 储 学 生 的 简单 信息 。 其 中 包括 如 下 两 个 表 : 
(1) Students 。 
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(2) Departments, 
两 个 表 的 字段 定义 和 相互 之 间 的 关系 如 图 7. 5 
所 示 。 表 Students 的 主键 为 StdId, 表 Departments 
的 主键 为 DeptId。 
首先 按照 代码 7. 20 中 定义 的 模式 创建 一 个 
SQLiteOpenHelper 子 类 DatabaseHelper, 并 定义 一 些 常量 。 
代码 7.21 定义 字符 串 常量 


Departments 


图 7.5 数据 库 表 及 关系 设计 


jimport android.oontent .ContentValues; 

import android.database.Cursor; 

import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 


Piblic class DatabaseHelper extends SQLiteopenHelper { 


static final String dbName= "demorB"; 
static final String studentTable= "Students"; 
static final String colID= "StdId"; 

static final String colName= "StdName"; 
static final String colage= "Age"; 

static final String colDept= "DeptId"; 


static final String deptTable= "Departments"; 
static final String colDeptID= "DeptId"; 

static final String colDeptName= "DeptName"; 

static final String viewStds= "ViewStds"; 

在 Android 系统 中 创建 数据 库 中 的 表 等 对 象 的 代码 在 onCreate() 方 法 中 执行 。 代 码 
7. 22 中 是 SQLiteOpenHelper 的 onCreate() 方 法 ,这 里 创建 了 两 个 表 及 其 字段 .一 个 视图 
和 一 个 触发 器 。 当 数据 库 创建 时 ,将 执行 这 些 代 码 。 也 就 是 当 这 个 数据 库 在 磁盘 中 不 存 
在 时 ,会 在 创建 它 的 时 候 执 行 一 次 。 这 个 onCreate() 方 法 的 代码 在 同一 个 设备 中 只 执行 
一 次 。 

代码 7.22 在 onCreate() 中 创建 数据 库 中 的 对 象 


Public void onCreate (SQLiteDatabase db) { 
//TIODO Rator generated method stub 


Ghb-execSQL ("CREATE, TABIE "+ deptTablet " ("+ colDeptID 
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+ "™ INIEGER PRIMARY KEY , "+ colDeptNamet " TEXT)"); 


中.execSQL ("CREATE TABIE "+ studentTabler " ("+ colID 
+ ™ INTEGER PRIMARY KEY AUTOINCREMENT, "+ colNamet " TEXT, ™ 
+ colAget " Integer, "+ colDept 
+ " INTEGER NOT NULL ,FOREIGN KEY ("+ colDept 
+ ") REEERENCES "+ dsptTablet " ("+ colDeptID+ "));"); 


db.execSQL ("CREATE TRIGER fk stodept deptid "+ "BEFORE INSERT " 
+" ON "+ studentTable + 
™ FOR FACH RON BEGIN"+ " SELECT CASE WHEN ((SEIECT " 
+ olDeptID+ " FROM "+ deptTablet " WHERE "+ oo1DeptID 
+ "=new."t colDeptt " ) IS NULL)" 
+ " THEN RATSE (ABORT, 'Foreign Key Violation') END;"+" FND;"); 


db.execsQL ("CREATE VIEW "+ viewStdst " RS SELECT "+ studentTable 
+ "oolIDt "AS _id,"+ " " studentTablet "." 
+ colNamet ", "+ " "+ studentTablet "."t colAget mn 
+" "deptTablet "."+ oolDeptNamet "+ " FROM " 
+ studentTablet " JOIN "+ deptTablet+ "CN "+ studentTable 
+"."+ colDept+ "= "+ deptTablet "."+ colDeptID) 7 
//Inserts pre- defined departments 
InsertDepts (dpb); 
} 


Android SDK 包括 了 SQLite 数据 库 工 具 , 可 以 用 这 些 工 具 来 浏览 表 的 内 容 , 运 行 
SQL 命令 ,以 及 执行 其 他 的 SQLite 数据 上 的 功能 。 
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数据 库 完 整 性 (Database Integrity) 是 指数 据 库 中 数据 的 正确 性 和 相 容 性 。 数 据 库 完 
整 性 由 各 种 各 样 的 完整 性 约束 来 保证 的 。 其 中 ,数据 库 的 外 键 约束 保障 了 数据 库 的 域 完 
整 性 和 参照 完整 性 。 也 就 是 说 ,外 键 约束 实现 了 表 与 表 之 间 的 联系 ,外 键 的 取 值 必须 是 另 

-个 表 的 主键 ,使 得 在 更 新 、 插 入 或 删除 操作 时 ,各 表 间 数据 保持 完整 性 。 

默认 情况 下 ,SQLite3 数据 库 不 支持 外 键 约束 。 要 实现 SQLite3 中 各 表 的 外 键 约束 
功能 ,需要 通过 定义 触发 器 Tigger 中 的 条 件 来 强制 实现 。 

下 面 使 用 图 7. 5 中 Students 表 和 Departments 表 之 间 外 键 约束 的 实现 作为 例子 ,说 
明 如 何 根 据 数据 库 设计 ,在 SQLite3 中 定义 外 键 约束 。 创 建 触发 器 的 SQL 语句 如 下 : 


CREATE, TRIGER fk_ stddept deptid Before INSFRT ON Students 

FCR FACH RON EEGIN 
SETECT CASE WHEN ( (SETECT DeptID FROM Dept WHERE DeptID= new.Dept) IS NULT) 
THEN RATSE (ABORT, 'Foreign Key Violation') END; 
ED 
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在 Android 代码 中 ,使 用 触发 器 实现 外 键 约束 功能 包括 以 下 两 个 步骤 : 

(1) 在 SQLiteOpenHelper 子 类 的 onCreate() 方 法 中 创建 触发 器 。 

(2) 覆盖 SQLiteOpenHelper 的 onOpen 方法 ,激活 触发 器 。 

首先 ,在 onCreate () 方 法 中 创建 数据 库 表 之 后 ,定义 创建 触发 器 的 语句 ,实现 外 键 约 
束 功能 。 在 代码 7. 22 中 使 用 execSQL0O 方 法 实现 了 上 面 的 创建 触发 器 功能 ,代码 如 下 : 


db.execSQL ("CREATE, TRIGHER 全 stddept deptid "+ " BEFORE INSEFT " 
+ " CN "+ studentTable + 
" FOR EACH RON BEGIN"+ " SETIRCT CASE WHEN ((SEILECT " 
+ colDeptID+ " FROM "+ deptTablet " WHERE "+ colDeptID 
+ "=new."t colDeptt" ) IS NULD)™ 
+ " THEN RRTSE (ABORT, 'Foreign Key Violation') END;"+" FND;"); 


然后 ,覆盖 onOpen() 方 法 ,激活 数据 库 中 的 外 键 , 强 制 实现 外 键 约束 ( 见 代码 7. 23)。 
代码 7.23 激活 外 键 约束 


@ override 
Public void onopen (SQLiteDatabase db) { 
Super.cnopen (db) ; 
证 (!db.isReadonly()) { 
//Enable foreign key constraints 
db.execSQL ("PRASMA foreign keys=ON;"); 
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创建 SQLiteDatabase 的 表 、 视 图 和 触发 器 等 对 象 后 ,就 可 以 对 数据 库 进行 数据 的 
CRUD 操作 , 即 添加 、 查 询 、 更 新 和 删除 操作 。 使 用 SQLiteDatabase 对 象 执行 SQL 语句 
的 方法 db. execSQL (String statement), 可 以 执行 INSERT、DELETE、UPDATE 和 
CREATE TABLE 之 类 有 更 改行 为 的 SQL 语 ;使 用 db. rawQuery() 和 db. Query 方法 ， 
可 以 执行 select 查询 语句 。 除 了 直接 执行 SQL 语句 的 方法 之 外 ,SQLiteDatabase 还 专门 
提供 了 对 应 于 添加 删除 ,更 新 .查询 的 操作 方法 : insert() 、delete() .update() 和 query()。 

要 查询 和 更 新 SQLite 数据 库 , 首 先 要 打开 数据 库 , 建 立 数据 库 连接 。Android 系统 
调用 SQLiteOpenHelper 的 getWritableDatabase() 或 者 getReadableDatabase() 方 法 打开 
数据 库 ,获取 用 于 操作 数据 库 的 SQLiteDatabase 实例 。 如 果 数 据 库 不 存在 , Android 系 
统 会 自动 生成 一 个 数据 库 , 然 后 调用 onCreate() 方 法 创建 数据 库 表 结构 及 其 他 数据 库 对 
象 ,并 添加 应 用 会 使 用 到 的 初始 化 数据 ,onCreate() 方 法 在 初次 生成 数据 库 时 才 会 被 调 
用 ,在 onCreate() 方 法 里 可 以 生成 数据 库 表 结构 及 添加 一 些 应 用 使 用 到 的 初始 化 数据 。 

getWritableDatabase() 和 getReadableDatabase() 方 法 都 可 以 获取 一 个 用 于 操作 数 
据 库 的 SQLiteDatabase 实例 。getWritableDatabase() 方 法 以 读 写 方 式 打 开 数 据 库 , 当 数 
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据 库 的 磁盘 空间 满 时 ,数据 库 就 只 能 读 而 不 能 写 ,会 发 生 错误 ,需要 进行 异常 处 理 。 而 
getReadableDatabase() 方 法 返回 的 对 象 与 getWritableDatabase() 类 似 ,但 当 数 据 库 的 磁 
盘 空 间 满 时 ,以 只 读 方式 打开 数据 库 , 问 题解 决 后 ,就 可 能 以 调用 getWritableDatabase() 
重新 返回 一 个 可 读 写 的 SQLiteDatabase 数据 库 对 象 。 不 过 getReadableDatabase() 返 回 
需要 花费 很 长 时 间 ,最 好 不 要 在 主线 程 中 调用 。 

一 旦 SQLiteDatabase 实例 被 缓存 ,多 次 调用 getWritableDatabase() 或 getReadable- 
Database() 方 法 得 到 的 都 是 同一 个 实例 。 如 果 不 再 使 用 数据 库 , 及 时 使 用 close( ) 方 法 关 
闭 数据 库 , 回 收 资源 。 

接 下 来 ,在 前 面 创建 的 数据 库 基 础 上 ,使 用 简单 的 例子 说 明 在 Android 系统 中 ,通过 
SQLiteDatabase 如 何 对 数据 库 进行 操作 。 

1. 插入 记录 

要 使 用 SQLiteDatabase 对 象 进行 插入 操作 ,首先 要 使 用 getWritableDatabase() 以 
可 读 写 的 方式 打开 与 数据 库 的 连接 ,然后 使 用 ContentValues 类 的 对 象 创建 一 个 记录 , 通 
过 ContentValues 类 的 put() 方 法 给 记录 逐个 字段 赋值 ,最 后 通过 SQLiteDatabase 的 
insert() 方 法 将 新 记录 插入 数据 库 中 ,关闭 数据 库 ( 见 代码 7.24) 。 

其 中 ContentValues. put(ColumnName，value) 参 数 有 两 个 ,ColumnName 是 表 的 字 
段 名 称 ,value 是 新 记录 的 值 。 

代码 7.24 定义 插入 记录 操作 AddStudent() 


void PodStudent (Student std) { 
SQLiteDatabase do= this.getWritableDatabase(); 
ContentValues cy= new ContentValues () 7 


cvV-PuL (colName, std.getName()); 
vput (colage，std.getaoe (0)) 7 
Vput (colDept, std.getDept()); 
//cv-put (colDept, 2); 


中 .insert (studentTable, colName, cv); 
db.close(); 
} 


对 于 insert() 方 法 本 身 来 说 ,无 论 的 第 三 个 参数 是 否 包含 数据 ,执行 insert() 方 法 一 
定 会 添加 一 条 新 记录 。 但 前 面 设置 了 外 键 约束 .这 里 的 插入 要 遵从 外 键 约 东 的 定义 。 同 
样 ,后 面 的 更 新 、 删 除 操作 都 要 遵从 外 键 约束 的 定义 。 

2. 更 新 记录 

Android 为 执行 更 新 语句 提供 两 种 方法 : 

(1) db. execSQL() 。 

(2) db. update() 。 
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与 插入 记录 类 似 , 要 使 用 getWritableDatabase() 以 可 读 写 的 方式 打开 与 数据 库 的 连 
接 , 使 用 ContentValues 对 象 创建 新 记录 和 赋值 ,在 更 新 数据 库 记 录 时 ,可 以 使 用 
execSQL() 方 法 ,直接 把 SQL 语句 按 格式 写 人 参数 中 ,也 可 以 使 用 update() 方 法 更 新 。 
代码 7. 25 中 说 明了 使 用 update() 方 法 如 何 更 新 记录 。 

update() 方 法 的 参数 包括 4 个 : 
String Table: 所 需 更 新 记录 的 表 名 。 
ContentValues cv: 赋予 新 值 后 的 记录 。 
String whereClause: 可 选 WHERE 子 句 ,格式 为 columnName 十 "一 ?" 或 null ,为 
null 值 则 更 新 所 有 行 。 
String[] whereArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 替 换 为 具 
体 的 值 , 没 有 WHERE 子 句 则 为 null。 
代码 7.25 定义 更 新 记录 操作 UpdateStd() 


Public int UpdateStd (Student std) { 
SQLiteDatabase do= this.getWritableDatabase (); 


ContentValues cy= new ContentValues(); 
cv.Put (colName, std.getName()); 
cv.Put (colpge, std.gethge()); 

cv.Put (colDept，std.getDept ())7 


retum db.update (studentTable, cv, colIDt =?", 
new String[] { String.valueOf (std.getID()) }); 
} 


3. 删除 记录 
Android 为 执行 删除 记录 提供 两 种 方法 : 
。 db. execSQL() 。 
。 db. delete() 。 
与 插入 和 更 新 SQLite 数据 库 类 似 , 使 用 getWritableDatabase() 以 可 读 写 的 方式 打 
开 与 数据 库 的 连接 后 ,删除 记录 可 以 使 用 execSQL() 方 法 ,也 可 以 使 用 delete() 方 法 。 代 
码 7. 26 说 明了 如 何 使 用 delete() 删 除数 据 库 中 符合 要 求 的 记录 。 
delete() 的 参数 定义 与 insert() 类 似 。 
代码 7.26 定义 删除 记录 操作 DeleteStd() 


Public void DeleteStd (Student emp) { 
SQLiteDatabase dbo= this.getWritableDatabase(); 


db.delete (studentTable, colIDt "=?", 


new String[] { String.valueOf (emp-getID()) }); 
db.close(); 
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4. 执行 查询 

Android 为 执行 查询 记录 提供 两 种 方法 : 

。 db. rawQuery() 。 

。 db. query() 。 

查询 记录 时 ,使 用 getReadableDatabase() 以 可 读 方式 打开 与 数据 库 的 连接 ,然后 把 
查询 条 件 以 参数 形式 代入 rawQuery() 或 query() 方 法 中 执行 ,返回 查询 结果 集 。 无 论 是 
rawQuery() 还 是 query() 方 法 ,每 个 SQLite 查询 都 会 返回 一 个 Cursor 对 象 , 它 指向 查询 
结果 的 所 有 行 , 即 结果 集 。Cursor 对 象 始终 能 够 在 数据 库 的 查询 结果 中 导航 ,并 且 能 够 
读 取 当 前 行 和 列 的 数据 。 

代码 7. 27 中 实现 了 查询 表 Departments 中 所 有 记录 的 功能 ,可 以 看 出 如 何 使 用 
rawQuery() 对 表 进 行 查询 。 

代码 7.27 rawQuery() 查 询 


Cursor getAllDepts() 
{ 
SQLiteDatabase do= this.getReadableDatabase(); 
Cursor cur= db.rawQuery ("SETRCT "+ colDeptIDt "as _id, 
"+ colDeptName+ ”from "+ deptTable,new String [] {}); 


retum our; 
1 
rawQuery() 的 参数 包括 两 个 : 
。 String query: 字符 串 形 式 的 选择 语句 ,其 中 WHERE 子 句 中 的 条 件 值 使 用 *?” 
代替 。 
。 String[] whereArgs: WHERE 子 句 中 “?” 对 应 的 具体 值 ,没有 WHERE 子 句 则 
为 null。 


代码 7. 27 中 查询 没有 WHERE 子 名 约束。 下面 的 语句 是 加 上 WHERE 子 句 约束 ， 
使 用 rawQuery() 实 现 的 查询 ,查询 结果 是 从 表 Students 中 查询 DeptId 值 为 2, 并 且 年 龄 
大 于 19 的 学 生 学 号 和 名 称 。 这 个 例句 中 可 以 更 进一步 清楚 说 明 rawQuery() 方 法 中 两 个 
参数 的 使 用 。 


Cursor cur= db.rawQuery("SEIPCT Stdrd as _iq，StdName FROM Students WHERE 
DeptId= ? RND Mge> = ?2", new String[] {"2", "19"}); 


这 个 查询 也 以 Cursor 对 象 作 为 返回 对 象 。 

在 rawQuery() 第 一 参数 的 SELECT 语句 中 ,如 果 数 据 表 的 主键 字段 的 名 称 不 是 
“_id”, 那 么 需要 使 用 “SELECT 字段 名 as _id” 子 句 把 主键 字段 的 别名 命名 成 “_id”, 因 为 
Cursor 对 象 总 是 把 名 为 *_id” 的 字段 作为 主键 ,否则 会 抛 出 异常 。 

另 一 种 执行 查询 的 方法 是 使 用 db. query() 方 法 ,代码 7. 28 使 用 query() 实 现 了 查询 
某 个 系 的 所 有 学 生 的 学 号 、 姓 名 、 年 龄 和 系 名 。 


7 


代码 7.28 query() 查 询 


Public Oursor getStdByDept (String Dept) { 
SQLiteDatabase do= this.getReadableDatabase (); 
String[] columns= new String[] { " id", colName, colAge, colDeptName }; 
Cursor c= db.query (viewStds, colurms, colDeptNamet = 2", 
new String[] { Dept }, mull, mll, mll); 
retum c; 
i 


query() 方 法 中 的 参数 , 按 顺序 分 别 为 : 

。 String TableName: 表 名 。 

。 String[ ] columns: 查询 结果 的 字段 。 

。 String[] whereArgs: WHERE 子 句 参数 。 
String GroupBy: 分 组 子 句 。 

。 String Having: HAVING 子 句 。 

String OrderBy : 排序 子 句 。 


745 管理 游标 


游标 (Cursor) 是 数据 库 系 统 为 用 户 开设 的 一 个 数据 缓冲 区 ,存放 SQL 语句 查询 的 执 
行 结果 。 每 个 游标 区 都 有 一 个 名 字 ,游标 能 从 包括 多 条 数据 记录 的 结果 集中 每 次 提取 一 
条 记录 进行 处 理 。 用 户 不 仅 可 以 用 SQL 语句 逐一 从 游标 中 获取 记录 ,并 赋 给 主 变量 , 交 
由 主语 言 进一步 处 理 。 游 标 还 允许 应 用 程序 对 查询 结果 集中 每 一 行进 行 相同 或 不 同 的 操 
作 ,而 不 是 一 次 对 整个 结果 集 进行 同一 种 操作 。 游 标 提 供 对 基于 游标 位 置 而 对 表 中 数据 
进行 删除 或 更 新 的 功能 。 

在 Android 系统 中 ,每 个 SQLite 查询 都 会 返回 一 个 Cursor 对 象 , 它 指向 查询 结果 的 
所 有 行 , 即 结果 集 。Cursor 类 提供 许多 方法 ,可 以 根据 需要 访问 结果 集中 的 记录 。 

Cursor 游标 常用 方法 如 下 : 
getCount() : 获得 总 的 数据 项 数 。 
isFirst() : 判断 是 否 为 第 一 条 记录 。 
isLast() : 判断 是 否 为 最 后 一 条 记录 。 
moveToFirst() : 移动 到 第 一 条 记录 。 
moveToLast() : 移动 到 最 后 一 条 记录 。 
move(int offset) : 移动 到 指定 记录 。 
moveToNext() : 移动 到 下 一 条 记录 。 
moveToPrevious() : 移动 到 上 一 条 记录 。 
getColumnIndexOrThrow(String columnName) : 根据 列 名 称 获 得 列 索引 。 
getInt(int columnIndex) : 获得 指定 列 索引 的 int 类 型 值 。 
getString(int columnIndex) : 获得 指定 列 缩影 的 String 类 型 值 。 
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对 于 代码 7. 28 的 查询 结果 ,可 以 通过 Cursor 对 象 的 访问 ,输出 到 控制 台 ( 见 代 
码 7.29) 。 
代码 7.29 结果 集 输出 


Public void PrintQuery (Cursor c) { 


if (Cursor.moweToFirst () { / 估 断 游标 是 否 为 空 
for (int i= 0;i< cursor.getCount ();i++){ /遍历 游标 
Cursor .move (i); 
int stdId= cursor.getInt (0); 
String stdName= cursor.getString (1); 
Int stdpge= cursor.getInt (2); 
String deptName= cursor.getString (3); 


// 输 出 用 户 信息 
System.out.println (stdIdt ": "+ stdName+ ": "+ stdnge+ 
": "+ deptNamet \n"); 


7.5 小 结 


本 章 主要 介绍 了 Android 系统 的 数据 存储 机 制 和 存 取 方 法 。Android 的 应 用 程序 可 
以 选择 的 本 地 数据 存储 方式 包括 共享 偏好 、 内 部 存储 、 外 部 存储 和 SQLite 数据 库 。 

共享 偏好 保存 用 户 配置 偏好 的 存储 方式 ,使 用 键 - 值 对 的 形式 保存 私有 的 原始 数据 ， 
以 XML 格式 将 数据 存储 到 设备 中 。 

Android 的 应 用 程序 都 会 使 用 两 种 文件 夹 ,一 种 是 在 内 部 存储 (Internal Storage) 上 ， 
用 来 保存 私有 数据 ;还 有 一 种 是 在 外 部 存储 (External Storage) 上 ,用 来 保存 公共 数据 。 
默认 情况 下 ,内 部 存储 文件 是 相应 程序 私有 的 ,对 其 他 程序 不 透明 ,对 用 户 也 是 不 透明 的 ， 
当 程 序 印 载 后 ,这 些 文件 就 会 被 删除 。 外 部 存储 的 文件 可 能 会 被 外 界 应 用 读 取 ,不 可 控 
制 。Android 系统 可 以 定义 三 种 作为 资源 的 文件 ,分 别 保存 在 三 个 不 同 资源 目录 中 ,分 别 
为 /res/xml、/res/raw 和 /assets。 

Android 中 通过 SQLite 数据 库 引擎 来 实现 结构 化 数据 存储 。Android 系统 通过 
SQLiteDatabase 类 来 对 SQLite 数据 库 进 行 访 问 , 该 类 封装 了 一 些 操作 数据 库 的 API, 使 
用 该 类 可 以 完成 对 SQLite 中 数据 进行 添加 (Create) 查询 (Retrieve) .更 新 (Update) 和 删 
除 (Delete) 操 作 。 
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任何 应 用 程序 都 可 以 通过 文件 系统 或 数据 库存 储 文件 ,其 他 应 用 程序 可 以 来 读 取 这 
些 文件 (当然 可 能 需要 某 些 访问 权限 的 设置 )。 在 Android 上 ,应 用 程序 的 所 有 数据 对 其 
他 应 用 程序 都 是 私有 的 ,其 他 应 用 只 有 通过 设置 权限 才 可 以 获取 数据 。Android 系统 提 
供 了 几 种 本 地 数据 的 存储 方式 ,如 果 要 将 这 些 数据 共享 的 话 ,Android 通过 定义 内 容 提供 
者 (ContentProvider) ,能 够 把 你 的 私有 数据 公开 给 其 他 应 用 程序 。 

ContentProvider 是 一 种 为 了 开放 应 用 程序 的 数据 读 写 ,具有 访问 权限 的 可 选 组 件 ， 
可 以 通过 这 个 组 件 实现 私有 数据 的 读 写 访 问 , 译 为 中 文 是 内 容 提 供 者 ”。Content- 
Provider 提 供 了 请 求 和 修改 数据 的 标准 语法 和 读 取 返 回 数据 的 标准 机 制 。Android 为 标 
准 的 数据 类 型 提供 了 一 些 ContentProvider, 如 图 像 .视频 和 音频 文件 ,以 及 个 人 通讯 录 信 
息 。Android 提供 几 种 持久 化 应 用 程序 数据 的 选择 ,具体 选择 哪 种 方式 依赖 于 具体 的 需 
求 ,例如 数据 应 该 是 应 用 程序 私有 的 还 是 共享 的 ,或 者 数据 所 需要 的 存储 空间 等 。 


8. 1 ContentProvider 基础 


ContentProvider 是 Android 系统 提供 给 用 户 的 一 个 接口 ,用 于 管理 如 何 访 问 应 用 程 
序 私 有 数据 的 存储 库 。 这 里 的 数据 包括 结构 化 存储 数据 和 非 结 构 化 存储 数据 。 
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上 一 章 提 到 过 ,一 般 情况 下 .一 个 Android 应 用 程序 的 数据 是 私有 的 ,其 他 应 用 程序 
不 具有 访问 的 权限 。 但 很 多 时 候 Android 应 用 程序 的 服务 包括 数据 的 服务 , 某 些 数据 希 
望 开放 给 其 他 Android 应 用 程序 使 用 。Android 系统 解决 这 个 问题 的 方法 是 定义 一 个 通 
用 的 、 格 式 统 一 的 数据 访问 接口 ,使 其 他 应 用 程序 可 以 通过 调用 这 个 接口 提供 的 方法 , 访 
问 和 修改 数据 。 

Android 系统 所 定义 的 访问 数据 资源 的 接口 称 为 ContentProvider。Content- 
Provider 主 要 是 被 其 他 应 用 程序 引用 ,为 应 用 程序 提供 一 个 一 致 的 ,标准 的 数据 访问 接 
口 , 其 中 包含 了 处 理 进 程 间 的 联系 和 数据 安全 访问 。 应 用 程序 向 外 部 开放 数据 访问 ,都 通 
过 ContentProvider 来 实现 。 

ContentProvider 向 外 部 应 用 程序 呈现 的 数据 就 像 一 张 二 维 表 ,如 同 在 关系 数据 库 里 
一 样 。 每 行 显示 一 些 数据 类 型 的 实例 , 列 的 每 行 显示 实例 数据 集合 的 字段 。 例 如 在 
Android 平 台 上 有 一 个 内 置 的 ContentProvider 用 户 词 典 ,存储 了 用 户 想 保存 的 非 标准 词 
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的 拼写 , 表 8-1 显示 了 数据 在 ContentProvider 表 中 的 样子 。 


表 8-1 用 户 词典 
Word app_id frequency locale 2 
mapreduce userl 100 en_US 于 
precompiler userl4 200 fr_ FR 区 
Applet user2 225 fr CA 3 
Const userl 225 fr_BR 4 
Int user5 100 en_UK 6 


在 表 8-1 中 ,每 行 代表 了 一 个 不 能 在 标准 字典 中 找到 的 词 ,每 一 列 代表 了 这 个 词 的 一 
个 属性 。 第 一 行 的 是 存储 在 ContentProvider 中 的 列 名 称 。 在 这 个 ContentProvider 中 ， 
_ID 列 作 为 “主键 ? 列 ,由 ContentProvider 自动 管理 维护 。 

主键 对 于 一 个 ContentProvider 并 不 是 必须 具备 的 ,即使 有 主键 ,ContentProvider 也 
不 必 一 定 要 使 用 _ID 作为 主键 的 列 名 。 但 是 ,如 果 要 把 ContentProvider 中 的 数据 通过 用 
户 界面 显示 出 来 ,常常 需要 把 ContentProvider 绑 定 到 一 个 称 为 ListView 的 用 户 界面 控 
件 上 ,这 就 必须 有 一 个 列 名 , 称 为 .ID。 在 后 面 讨论 显示 查询 结果 的 部 分 ,会 对 此 有 详细 
的 解释 。 
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应 用 程序 使 用 ContentResolver 客户 端 对 象 来 访问 ContentProvider 的 数据 ,可 以 称 
其 为 访问 提供 器 。ContentResolver 的 方法 提供 了 基本 的 CRUD( 创 建 , 检 索 、 更 新 和 删 
除 ) 数 据 存储 的 功能 。 

应 用 程序 通过 ContentResolver 的 对 象 访问 ContentProvider 时 ,所 使 用 的 方法 会 调 
用 ContentProvider 一 个 具体 子 类 对 象 的 相同 名 字 的 方法 。 例 如 ,为 了 从 用 户 字典 的 
ContentProvider 中 获得 单词 和 它们 出 现 的 语言 环境 列表 ,可 以 使 用 ContentResolver 
,query() 方 法 ( 见 代 码 8.1)。 这 个 queryQ 〇 方法 会 调用 在 用 户 字典 ContentProvider 中 定 
义 的 ContentProvider. query() 方 法 。 

代码 8.1 ContentResolver. query() 的 调用 


// 访 问 用 户 字典 并 返回 游标 
Oursor= getContentResolver () .query( 
UserDicticnary.Words.CONTENT URI，  // 词 表 的 内 容 URI 


mprojection, // 每 行 中 返回 数据 的 列 的 名 称 
//nnll 表 示 返 回 所 有 列 的 数据 

mselectionclause // 过 滤 条 件 

mSelectionArgs, // 过 滤 条 件 的 参数 

mSortOrder)7 // 返 回 行 的 排序 方式 


ContentProvider. query() 方 法 的 参数 与 SQL 语言 中 SELECT 语句 的 参数 类 似 ,说 
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明 如 下 : 


Uri uri: Content URI, 对 应 provider 中 的 表 名 。 
String[ ] projection: 查询 结果 中 包含 的 字段 。 
String selection: 可 选 WHERE 子 句 ,格式 为 columnName 十 "= 二?" 或 null, 为 null 
值 则 更 新 所 有 行 。 
String[ ] selectionArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 蔡 换 为 
具体 的 值 ,没有 WHERE 子 句 则 为 null。 
String sortOrder: 排序 子 句 。 

因此 ,在 使 用 其 他 应 用 程序 定义 的 provider 数据 时 , 对 于 应 用 程序 来 说 ， 
ContentResolver 的 对 象 只 是 一 个 访问 器 ,用 于 与 provider 连接 以 及 传递 操作 和 参数 ,并 
不 需要 知道 数据 的 具体 存储 结构 ,也 不 需要 编码 实现 功能 ,具体 的 访问 操作 由 provider 子 
类 的 同名 方法 来 完成 。 这 样 ,其 他 应 用 程序 只 要 了 解 provider 的 数据 二 维 表 , 就 可 以 完成 
数据 交互 。 

当然 ,如 果 要 访问 provider, 应 用 程序 必须 在 manifest 文件 中 添加 特定 的 权限 。 这 些 
将 在 ContentProvider 权限 中 详细 介绍 。 

客户 端 应 用 程序 进程 中 的 ContentResolver 对 象 和 ContentProvider 对 象 会 自动 处 
理 进 程 间 通信 。ContentProvider 也 会 以 二 维 表 的 形式 ,在 存储 的 数据 和 数据 外 部 显示 之 
间作 为 中 间 的 抽象 层 。 
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在 调用 ContentProvider. query ( ) 方法 时 ,第 一 个 参数 是 Uri 类 的 对 象 。Uri 是 
Android 用 来 描述 Content URI 的 类 。 

什么 是 内 容 统 一 资源 标识 符 (Content URI) 呢 ? 通用 资源 标志 符 (Universal 
Resource Identifier) 简 称 URI。Content URI 就 是 ContentProvider 中 数据 的 内 容 统 一 资 
源 标识 ,能 够 在 存储 介质 中 唯一 标识 ContentProvider 中 数据 所 在 的 具体 位 置 。 这 有 点 类 
似 通过 Web 地 址 去 访问 网 页 。ContentProvider 对 象 通过 URI 来 选择 要 访问 provider 的 
表 和 数据 , 当 调 用 ContentResolver 客户 端的 方法 来 访问 provider 中 的 一 个 表 时 ,会 把 这 
个 表 对 应 的 URI 标识 作为 参数 传递 给 调用 的 方法 。 

在 Android 系统 中 ,Content URI 主要 分 为 3 个 部 分 : scheme authority 和 path。 其 
中 authority 又 分 为 host 和 port( 见 图 8. 1) 。 


content://com.example.transportationprovider/trains/122 
-人 - 


A B C DD 
图 8.1 Content URI 结构 


一 般 来 说 ,资源 标识 符 的 结构 包括 协议 类 型 .资源 名 称 和 路 径 。 下 面 对 照 Internet 的 
统一 资源 定位 符 , 分 别 说 明 在 Content URI 中 这 三 部 分 的 具体 定义 。 

(1) 协议 类 型 : 称 为 scheme, 对 应 图 8. 1 中 的 A 部 分 ,表示 资源 的 类 型 。 如 果 是 网 站 
资源 则 为 “HTTP://”,Content URI 则 为 “content://”。 
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(2) 资源 名 称 : 称 为 authority, 对 应 图 8. 1 中 的 B 部 分 ,表示 资源 的 唯一 名 称 。 如 果 
是 网 站 资源 则 为 域名 ,Content URI 中 则 是 provider 的 唯一 标识 名 称 ,可 以 使 用 包 和 类 名 
来 定义 provider 资源 名 称 。 

(3) 路 径 : 称 为 path, 对 应 图 8. 1 中 的 C 和 D 部 分 ,表示 资源 中 的 数据 。 如 果 是 网 站 
资源 则 为 服务 器 上 网 页 的 路 径 名 ,Content URI 中 则 是 provider 中 的 表 名 或 指定 表 中 的 
记录 。 例 如 图 8.1 中 C 和 DD 都 是 用 来 指定 路 径 ,C 一 般 用 来 指定 数据 库 中 表 的 名 字 , 这 
里 指出 使 用 trains 表 中 的 数据 ,D 可 以 用 来 指定 数据 库 中 的 一 条 记录 ,这 里 指定 了 ID 为 
122 的 记录 ,如 果 没 有 指定 ID ,就 表示 返回 全 部 记录 。 


814 MME 类 型 


MIME 的 英文 全 称 是 Multipurpose Internet Mail Extensions, 称 为 多 用 途 互 联网 邮 
件 扩展 。 这 是 一 种 互联 网 标准 。1992 年 ,MIME 最 早 应 用 于 电子 邮件 系统 ,但 后 来 也 应 
用 到 浏览 器 。 当 用 户 访问 网 站 资源 时 ,服务 器 会 返回 资源 的 MIME 类 型 ,浏览 器 会 根据 
MIME 类 型 调用 正确 的 程序 来 查看 内 容 。 

ContentProvider 也 为 给 定 资源 定义 了 MIME 类 型 。 每 个 MIME 类 型 由 两 部 分 组 
成 ,前 面 是 数据 的 大 类 别 ( 例 如 audio 代表 声音 数据 .image 代表 图 像 数据 text 代表 文本 
数据 等 ) ,后 面 定义 具体 的 子 类 别 ,格式 为 : 大 类 别 / 子 类 别 。 例 如 下 面 是 一 些 常 用 的 
MIME 类 型 。 
text/html。 


text/css。 


text/xml。 


text/vnd. curl。 


application/ pdf。 


application/rtf。 


application/vnd. ms-excel。 
Internet 中 有 一 个 专门 组 织 IANA 来 确认 标准 的 MIME 类 型 ,在 IANA 互联 网 数字 
分 配 机 构 网 站 上 可 以 看 到 已 注册 的 类 型 和 子 类 型 的 完整 列表 ,网 址 如 下 : 


http://ww.iana.org/assigrments/media-— types/ 


已 注册 的 主要 类 型 包括 application、audio、example、message、model、multipart、text、 
video。 如 果 供 应 商 具 有 专用 的 数据 格式 ,那么 子 类 型 名 称 将 以 vnd 开头 ,例如 微软 Excel 
电子 表格 使 用 子 类 型 vnd. ms-excel 标识 ,而 pdf 被 视 为 一 种 专用 供应 商标 准 , 所 以 对 它 
的 标识 没有 任何 供应 商 特 定 的 前 级 。Internet 发 展 得 太 快 ,很 多 应 用 程序 等 不 及 IANA 
来 确认 它们 使 用 的 MIME 类 型 为 标准 类 型 。 因 此 它们 使 用 在 类 别 中 以 x- 开 头 的 方法 标 
识 这 个 类 别 还 没有 成 为 标准 ,例如 x-gzip、x-tar 等 。 事实 上 这 些 类 型 运用 的 很 广泛 ,已 经 
成 为 事实 标准 。 只 要 客户 机 和 服务 器 共同 承认 这 个 MIME 类 型 ,即使 它 是 不 标准 的 类 型 
也 没有 关系 ,客户 程序 就 能 根据 MIME 类 型 ,采用 有 具体 的 处 理 手段 来 处 理 数 据 。 而 Web 
服务 器 和 浏览 器 (包括 操作 系统 ) 中 ,默认 都 设置 了 标准 的 和 常见 的 MIME 类 型 ,只 有 对 
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于 不 常见 的 MIME 类 型 , 才 需 要 同时 设置 服务 器 和 客户 浏览 器 ,以 进行 识别 。 

Android 遵循 类 似 的 约定 来 定义 MIME 类 型 ,而 且 每 个 内 容 类 型 的 MIME 类 型 都 具 
有 两 种 形式 : 单条 记录 和 多 条 记录 。 

对 于 单条 记录 ,MIME 类 型 类 似 于 : 


vnd.android.cursor.item/vnd.yourompanyname .oontenttype; 
对 于 多 条 记录 ,MIME 类 型 类 似 于 : 
vnd.android.cursor.dir/vnd.yourompanyname .oontenttype 


上 面 两 个 MIME 类 型 中 ,vnd. android. cursor. dir 表示 返回 多 行 结果 ;vnd. android. 
cursor ,item 表示 返回 单行 结果 ,而 子 类 型 是 指 特定 的 provider。Android 内 置 的 
provider 通常 有 一 个 简单 的 子 类 型 。 例 如 ,通讯 录 的 应 用 中 , 当 创 建 一 个 电话 号 码 时 ,可 
以 设置 MIME 的 类 型 为 : vnd. android. cursor. item/phone_v2, 其 中 子 类 型 为 phone_v2。 

Content Provider 开发 人 员 可 以 基于 provider 资源 名 称 和 表 名 创建 他 们 自己 的 子 类 
型 模式 。 例 如 考虑 一 个 包含 列车 时 刻 表 的 provider,provier 的 资源 名 称 为 com. example. 
trains, 其 包含 的 表 有 Linel、Line2 和 Line3。 如 果 访 问 表 Linel 的 Content URI 为 : 


content://cam.exanple.trains/Tinel 

则 对 于 表 Linel ,provider 返回 MIME 类 型 为 多 条 记录 : 
如 果 访 问 表 Line2 的 Content URI 为 : 
content://camexample.trains/Line2/5 


则 对 于 表 Line2 的 行 5,provider 返回 MIME 类 型 为 单条 记录 : 


nd.android.cursor.item/vnd.exanple.line? 


ContentProvider 类 提供 了 两 个 方法 返回 MIME 类 型 ,其 中 getType() 方 法 是 必须 实 
现 的 方法 ;如 果 使 用 ContentProvider 提供 文件 类 型 数据 ,需要 实现 getStreamTypes() 
方法 。 


8.2 使 用 ContentProvider 


下 面 介 绍 ContentProvider 的 使 用 方法 。 
821 获取 数据 
Android 应 用 程序 通过 Content URI 定位 .来 获取 ContentProvider 中 所 需要 的 数 
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据 。Content URI 对 于 ContentProvider 来 说 是 唯一 的 ,对 于 开发 人 员 来 说 也 是 非常 重要 
的 。 因 此 ,通常 在 ContentProvider 中 将 Content URI 定义 为 常量 ,以 方便 开发 人 员 的 引 
用 。 下 面 是 Android 系统 预定 义 的 一 些 ContentProvider 的 Content URI 常量 。 


MediaStore. Images.Media. INIFEFNAL OONTENT URI 
MediaStore. Images.Media.EXIFERNAL OONTENT URI 
ContactsContract .Contacts.CONTENT URI 


这 些 常 量 对 应 的 Content URI 的 值 如 下 : 
content://media/internal/images 


content://media/external/images 
content://com.androiq.contacts/contacts/ 


Android 系统 的 内 置 通 讯 录 Provider 使 用 ContactsContract. Contacts. CONTENT_ 
URI 常量 来 标识 provider 中 联系 人 数据 。 

有 了 具体 的 Content URI, 为 了 从 Provider 中 检索 数据 ,需要 两 个 基本 步 又， 

。 给 提供 器 申请 读 访 问 权 限 。 

。 构造 查询 代码 。 

下 面 以 用 户 词典 的 ContentProvider 为 例 ,说 明 如 何 从 其 中 获取 数据 。 

1. 给 提供 器 申请 读 访问 权限 

能 够 从 ContentProvider 中 获取 数据 的 前 提 , 首 先是 所 访问 的 ContentProvider 允许 
其 他 应 用 程序 的 读 访问 。 

从 ContentProvider 中 获取 数据 ,应 用 程序 需要 “ 读 权限 ”。 这 个 权限 不 能 在 应 用 程序 
运行 时 设置 ,需要 在 应 用 程序 的 manifest 文件 中 里 预先 声明 需要 的 权限 元 素 。 如 果 指 定 
了 这 个 元 素 , 当 用 户 安装 这 个 应 用 程序 时 ,系统 会 隐 式 地 付 给 其 相应 的 权限 。 

manifest 文件 中 的 权限 声明 元 素 是 二 uses-permission 二 元 素 , 权 限 的 值 从 将 要 访问 
ContentProvider 所 定义 的 权限 中 选择 ,根据 需求 指定 准确 的 权限 名 称 。 例 如 ,用 户 字典 
的 ContentProvider 的 定义 了 权限 android. permission. READ_USER_DICTIONARY， 
作为 其 可 读 取 的 权限 。 如 果 应 用 程序 需要 从 用 户 字典 的 ContentProvider 读 取 数据 ,就 需 
要 在 其 manifest 文件 里 声明 用 户 字 典 的 ContentProvider 的 可 读 取 。 代 码 如 下 : 


<Uses- Fermissicn android:nare= " android.pemmissin.FEAD USER DICTIOPRY"/> 


在 使 用 不 同 的 ContentProvider 时 ,如 果 要 了 解 所 使 用 的 ContentProvider 有 哪些 具 
体 的 访问 权限 和 权限 确切 的 名 字 , 可 以 参考 ContentProvider 的 文档 。 

2. 构造 查询 代码 

权限 申请 完成 后 ,从 ContentProvider 中 检索 数据 的 第 二 步 就 是 构建 查询 程序 。 接 下 
来 ,以 用 户 词典 的 ContentProvider 为 例 ,说 明 如 何 使 用 ContentResolver. query() 获 取 其 
中 的 数据 。 

由 于 ContentResolver. query() 的 参数 对 应 于 SEIECT 语句 的 结构 ,类 似 于 关系 数据 
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库 表 的 查询 。 如 果 要 获取 某 个 ContentProvider 中 的 数据 ,必须 要 清楚 这 个 
ContentProvider 可 以 提供 什么 数据 内 容 , 也 就 是 明了 这 个 二 维 表 的 结构 。 这 可 以 从 
ContentProvider 的 文档 中 查 到 。 

首先 在 应 用 程序 中 ,对 应 ContentResolver. query() 的 参数 ,声明 一 些 访问 用 户 词典 
provider 所 需要 的 一 些 变量 ( 见 代 码 8. 2)。 

代码 8.2 变量 声明 


String[] mProjecticn= { 
UserDictionary.Words._ID, 
//Contract class constant for the _ID column name 
//Contract class constant for the word colum name 
//contract class constant for the locale colum name 
a 


//Defines a string to contain the selection clause 
String mSelectionClause= null; 


//Initializes an array to contain selection arguments 
String[] mSelectionArgs= {"™"}; 
. 


当 调 用 ContentResolver. query ( ) 方法 时 , 其 实际 调用 了 Provider 中 的 
ContentProvider. query() 方 法 。ContentResolver. query() 方 法 返回 的 结果 是 一 个 游标 对 
象 , 下 面 详 细 说 明 其 参数 的 作用 。 

。 Uri uri: 对 应 Provider 中 的 表 名 对 对 应 的 Content URI。 

。 String[ ] projection: 查询 结果 中 包含 的 字段 。 这 是 一 个 数组 ,指定 需要 返回 数据 
的 列 , 如 果 为 null 则 返回 所 有 列 。 从 效率 上 来 说 ,如 果 不 是 用 到 所 有 的 列 ,最 好 明 
确 指定 。 

String selection: 指定 过 滤 数 据 的 条 件 ,其 格式 相当 于 SQL 选择 语句 中 的 
WHERE 子 句 的 条 件 表达 式 , 如 果 为 null, 则 表示 返回 所 有 行 。 一 般 来 说 ,查询 数 
据 的 SQL 表达 式 是 有 WHERE 条 件 的 ,而 ContentResolver. query() 方 法 中 的 
selection 参数 就 对 应 WHERE 条 件 来 说 , 它 是 一 个 逻辑 布尔 值 、 列 名 、 数 值 的 复 
合 表达 式 。 

String[ ] selectionArgs: 如 果 在 selection 参数 使 用 了 “?” 占 位 符号 ,表示 这 个 位 置 
需要 指定 一 个 条 件 值 。 而 这 个 数值 是 由 selectionArgs 参数 指定 的 。 如 果 
selection 参数 中 有 多 个 “?” 占 位 符 , selectionArgs 参数 中 字符 串 数组 的 顺序 与 
selection 参数 顺序 一 致 。 


基于 Ardroid 平 台 的 移动 互联 网 开发 


为 什么 需要 通过 这 种 方式 传人 条 件 参数 呢 ? 这 是 为 了 防止 恶意 输入 SQL 语句 。 如 
果 ContentProvider 管理 的 数据 保存 在 SQL 数据 库 里 ,假设 有 外 部 不 可 信 的 数据 插入 到 
原始 的 SQL 语句 中 ,有 可 能 导致 恶意 SQL 输入 。 

假设 条 件 参数 变量 定义 如 下 : 


String mSelectionClause= "var= "+ nrUserInput; 


如 果 mUserInput 是 一 个 需要 用 户 输入 的 变量 ,这 就 为 插入 恶意 的 SQL 语句 提供 了 
条 件 , 例 如 用 户 可 以 在 界面 为 mUserInput 变量 输入 : 


nothing; DROP TABIE * ; 


这 样 在 数据 库 上 执行 的 就 不 止 一 条 查询 语句 ,会 执行 DROP 操作 ,就 会 导致 
ContentProvider 删除 SQLite 数据 库 里 所 有 的 表 。 为 了 解决 这 个 问题 ,使 用 一 个 带 有 “*?” 
作为 可 替代 的 选择 参数 ,然后 在 使 用 另 一 个 的 选择 参数 数组 来 组 合 定 义 查 询 方 法 。 这 样 ， 
用 户 的 输入 会 直接 绑 定 到 查询 方法 的 选择 参数 中 ,而 不 是 作为 SQL 语句 的 一 部 分 被 解 
释 。 由 于 它 没有 被 视 为 是 SQL 语句 ,用 户 输入 不 可 以 注入 恶意 的 SQL。 

。 String sortOrder: 排序 子 句 。 指 定数 据 行 的 排列 规则 ,其 格式 相当 于 SQL 语句 

的 ORDER BY 子 句 中 的 表达 式 。 如 果 为 null, 则 使 用 默认 的 排序 方式 ,或 者 不 
排序 。 

代码 8. 3 定义 好 变量 ,就 可 以 编写 获取 数据 的 方法 。 

代码 8.3 获取 ContentProvider 数据 


private Cursor getWordDictionary(String mSearchstring) { 
String mSelectionClause; 
String[] mSelectionArgs= new String[1]; 
if (TextUtils.isEmpty (mSearchString)) { 
mSelectionClause=null; 
mSelectionArgs=null; 
}else{ 
mSelectionClause= UserDictionary.Words.WORD+ "= 2"; 
mSelectionArgs[0]=mSearchString; 
} 
Cursor nCursor= getContentResolver () .query( 
UserDictionary.Words.ONTENT URI, 
mProjection, 
mSelectionClause, 
mSelectionArgs, 
mSortOrder); 
retum mCursor; 
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3. 显示 查询 结果 

ContentResolver. query() 方 法 执行 后 ,返回 的 是 游标 对 象 ,这 是 一 个 查询 结果 集合 。 
如 果 遍 历 这 个 游标 对 象 ,就 可 以 读 取 结 果 集 中 的 所 有 数据 ,输出 查询 结果 。 代 码 8. 4 中 使 
用 Cursor 的 move() 方 法 在 结果 集中 移动 游标 指针 ,使 用 Cursor 的 getString() 方 法 获取 
当前 记录 各 字段 的 值 ,并 在 控制 台 输 出 一 个 记录 结果 。 

代码 8.4 输出 查询 结果 


Public void printQueryResult (Cursor c) { 


if (cursor.moveToFirst() { 
for (int i= 0;i< cursor.getCount ();i++){ 
Cursor.move (i); 
String word= cursor.getString (0); 
String user= cursor.getString (1); 
String local= cursor.getString(2); 


// 输 出 用 户 信息 
System.out-println (wordt ": "+ usert ": "+ local+ \n"); 
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如 果 需 要 插入 、 更 新 或 者 删除 数据 ,首先 要 考虑 的 还 是 权限 的 问题 。 

需要 为 ContentProvider 定义 不 同 的 数据 访问 权限 ,以 便 其 他 应 用 能 够 访问 其 提供 的 
数据 。 权 限 的 定义 可 以 保证 用 户 能 够 知道 应 用 程序 中 的 哪些 数据 可 以 访问 。 基 于 
ContentProvider 提供 的 说 明 , 其 他 的 应 用 程序 可 以 根据 自身 的 需求 来 申请 权限 去 访问 
ContentProvider。 最 后 ,用 户 在 安装 此 应 用 时 会 看 到 该 应 用 请 求 获得 的 权限 。 

如 果 包 含 ContentProvider 的 应 用 没有 指定 任何 权限 ,其 他 的 应 用 程序 是 无 法 访问 该 
ContentProvider 的 数据 的 。 但 是 无 论 是 否 指 定 了 权限 ,包含 ContentProvider 应 用 的 其 
他 组 件 拥有 对 该 ContentProvider 的 完全 读 写 权限 。 

正如 上 面 所 说 ,用 户 字 典 的 ContentProvider 要 android. permission. WRITE_USER_ 
DICTIONARY 权限 控制 对 数据 的 插入 、 更 新 和 删除 。 

为 获得 访问 ContentProvider 的 权限 ,应 用 程序 在 manifest 文件 中 需要 使 用 uses- 
permission 标签 。 当 Android Package Manager 安装 应 用 时 ,用 户 必须 批准 应 用 程序 的 
所 有 权限 请 求 。 如 果 用 户 人 允许 了 ,Package Manager 会 继续 安装 流程 ;如 果 用 户 不 允许 ， 
Package Manager 会 终止 安装 。 

例如 ,在 应 用 程序 中 插入 、 更 新 或 者 删除 用 户 字典 ContentProvider 的 数据 ,需要 在 
Manifest 文件 中 声明 android. permission. WRITE_USER_DICTIONARY 权限 ,例如 : 
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< uses— Fermissicn android:neme= "android.permmission.WRITE USFR DICTIORPRY"/> 


1. 插入 数据 

如 果 向 ContentProvider 中 插入 数据 ,需要 调用 ContentResolver. insert() 方 法 。 这 
个 方法 向 ContentProvider 中 插入 一 行 新 数据 ,然后 返回 该 行 数据 的 资源 标识 符 。 

ContentResolver. insert() 方 法 的 参数 说 明 如 下 : 

。 Uri url: 资源 标识 符 Content URI。 

。 ContentValues values: ContentValues 对 象 ,存储 所 要 插入 的 新 记录 各 字段 的 值 。 

ContentValue 对 象 的 使 用 与 前 一 章 相 同 ,使 用 ContentValue. put() 分 别 给 每 个 字段 
赋值 ,前 一 个 参数 是 Provider 表 定 义 的 字段 名 称 , 后 一 个 参数 是 给 这 个 字段 的 赋值 。 

代码 8. 5 中 实现 了 给 用 户 字典 Provide 添加 一 行 新 记录 的 功能 。 首 先 创 建 一 个 新 的 
ContentValue 对 象 ,通过 put() 把 值 分 别 赋 给 各 个 字段 。 这 条 数据 中 并 没有 插入 _ID 字 
段 , 那 是 因为 它 会 自动 地 增加 到 数据 中 。Provider 会 给 每 一 行 数据 赋予 一 个 唯一 的 _ID， 
而 它 往往 就 被 看 作 数 据 库 表 中 的 主键 。 

代码 8.5 插入 数据 


Uri nmNewUri; 
//Defines an cabject to contain the new values to insert 
ContentValues mrNewNalues= new ContentValues () 7 
/* 
# Sets the values of each column and inserts the word. The 
# arguments to the "put" method are "colum name" and "value" 
Cp 
ewalues.put (UserDictionary.Words.APP_ID, "example.user"); 
enalues.put (UserDicticnary.Words.IOCAIE, "en US"); 
NewWalues .put (UserDictionary.Words.WORD, "insert"); 
rNewWalues.put (UserDictionary.Words .FREQUENCY, "100"); 


mewUri= getContentResolver() .insert ( 
UserDictionary.Words.OONTENT URI, 
nNewalues //the values to insert 

); 

Cursor= getWordDictionary (nul1); 

mCursorndapter .changeCursor (rmOursor); 

Toast .makeText (this, 哺 人 数据 为 "+ nNewUri .gatEnoodedPath()， 

Toast.IENGTH SHORT) .show (); 


ContentResolver. insert() 方 法 的 返回 值 为 新 增加 行 的 资源 标识 符 , 如 下 格式 : 
content://user dictionary/words/< id value> 


其 中 的 id_value 为 新 增 行 的 _ID。Android 系统 还 提供 了 自动 检测 资源 标识 符 格式 
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的 API, 例 如 调用 ContentUris. parseld() 方 法 ,返回 资源 标识 符 的 _ID 值 。 


2. 更 新 数据 
如 果 要 更 新 Provider 中 的 数据 ,需要 使 用 ContentResolver. update() 方 法 。 与 插入 


数据 类 似 , 使 用 ContentValues 对 象 来 存储 更 新 数据 ,同时 与 查询 语句 相同 的 条 件 参数 。 
如 果 仅 仅 需要 更 新 某 些 字段 ,只 需要 把 这 些 字段 的 值 添加 到 ContentValues 对 象 中 。 如 
果 需 要 清除 一 列 的 值 , 则 把 这 列 设 为 null。 


ContentResolver. update() 方 法 的 参数 说 明 如 下 : 

Uri uri: Content URI。 

ContentValues values: 带 有 记录 更 新 值 的 ContentValues 对 象 。 

String where: WHERE 子 句 ,具体 的 条 件 值 使 用 *?” 替 代 。 

String[] selectionArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 替 换 为 
具体 的 值 , 没 有 WHERE 子 句 则 为 null。 

用 来 定义 要 更 新 的 列 和 更 新 的 值 , 如 果 要 清除 某 一 列 的 内 容 , 就 使 用 


ContentValues. putNull() 方 法 将 此 值 设 为 null。 下 面 的 代码 改变 每 行 word 列 中 以 in 开 
头 的 单词 为 update, 返 回 的 值 为 更 新 的 行 数 : 


代码 8.6 的 例子 中 实现 了 对 用 户 字典 Provider 表 中 记录 的 条 件 更 新 , 选 出 word 字 


段 值 中 以 en 开头 的 记录 ,把 其 local 字段 更 新 为 null。 


代码 8.6 更 新 数据 


//Defines an cbject to contain the updated values 
ContentValues mrDpdateValues= new ContentValues () 7 


//Defines selection criteria for the rows you want to update 
String mSelectionclause= UserDictionary.Words.IOCALE+ "LIKE 2"; 
String[] mSelectionArgs= {"en % "}; 


//Defines a variable to contain the nurber of updated rows 
int mRowsUpdated= 0; 
/¥ 
* Sets the updated value and updates the selected words 
关 / 


RowsUpdated= getContentResolver () .update( 
UserDictionary.Wbrds.CONTFENT URI, //the user dictionary content URI 


了 //the columns to update 
mSelectionClause //the column to select on 
mSelectionArgs //the valve to ompare to 


MOUursor= getWordDicticnary (null) > 
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mCursorAdapter .changeCursor (mCursor); 
System.out.printin('" 蝎 新 行 数 为 "+ mRowsUpdated) ; 


3. 删除 数据 

如 果 要 删除 Provider 中 的 数据 ,需要 使 用 ContentResolver. delete() 方 法 。 删 除 
Provider 中 的 数据 与 查询 获取 数据 很 类 似 ,delete() 方 法 不 需要 构造 新 的 记录 ,只 需要 指 
定 想 删 除 行 的 选择 条 件 参 数 ,返回 值 是 删除 的 行 数 。 

ContentResolver. delete() 方 法 的 参数 说 明 如 下 : 

。 Uri uri: Content URI。 

。 String where: WHERE 子 句 ,具体 的 条 件 值 使 用 *?? 蔡 代 。 

。 String[ ] selectionArgs: WHERE 子 句 中 的 参数 ,把 whereClause 中 的 “?” 蔡 换 为 

具体 的 值 , 没 有 WHERE 子 句 则 为 null。 

下 面 的 代码 删除 word 列 中 以 in 开头 的 单词 ,返回 删除 的 行 数 。 

代码 8.7 的 例子 中 实现 了 对 用 户 字 典 provider 表 中 记录 的 删除 ,删除 word 字段 值 
中 以 in 开头 的 记录 。 

代码 8.7 删除 数据 


mselectionclause= UserDictionary.Words.WORD+ " LIFE 2"; 

mSelectionArgs[0]= "ings "; 

//Defines a variable to contain the mmber of rows deleted 

int mRowsDeleted; 

//Deletes the words that match the selection criteria 

rRowsDeleted- getContentResolver() .delete ( 
UserDictionary.Words.OONIENT URI， ”//the user dicticnary 资 源 标识 符 


mSelectionClause, //the colum to select on 
mSelectionArgs //the value to compare to 
) 
ICursor= getWordDictionary (oul1) > 
mCursorAdapter .changeCursor (mnCursor) > 


System.out.printin ("删除 行 数 为 +mRowsUpdated) ; 


4. 批 处 理 模式 

Android 系统 还 提供 了 另外 一 种 操作 数据 的 方法 , 称 为 批 模式 。 批 模式 可 以 一 次 在 
一 个 表 中 插入 多 行 , 或 者 插入 行 到 多 个 表 中 ,或 者 定义 一 个 事务 完成 一 系列 跨 处 理 边界 的 
操作 。 

如 果 要 通过 批 模式 访问 Provider, 需 要 创建 包含 ContentProviderOperation 对 象 的 
操作 数组 ,然后 通过 ContentResolver. applyBatch() 方 法 ,将 操作 数组 派发 到 Provider 上 
执行 。 操 作 数 组 中 的 ContentProviderOperation 对 象 可 以 对 应 不 同 的 表 。ContentResolver . 
applyBatch() 方 法 返回 值 为 一 个 数组 。 

ContentResolver. applyBatch() 方 法 的 参数 说 明 如 下 : 

。 String authority: 字符 串 形 式 的 Content URI 中 表 的 标识 ,指向 需要 操作 的 表 。 
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。 ArrayList<ContentProviderOperation 二 operations: 具体 的 操作 。 

代码 8. 8 中 的 例子 ,通过 使 用 批 处 理 模式 对 ContactsContract 插入 操作 ,说 明了 如 何 
使 用 ContentResolver. applyBatch() 方 法 。 

ContactsContract 是 Android 为 通信 录 提 供 的 provider。 从 Android 2.0(API Level 
5) 开 始 ,Android 平台 提供 了 一 个 改进 的 Contacts API, 以 适应 一 个 联系 人 可 以 有 多 个 账 
户 的 需求 ,比如 说 ,手机 通讯 录 和 Gmail 通讯 录 , 两 个 通讯 录 中 的 两 条 记录 可 以 是 同一 个 
人 人。 新 的 Contacts API 主要 是 由 ContactsContract 及 其 相关 的 类 来 管理 ,联系 人 数据 被 
放 到 三 张 表 中 : Data、RawContacts 和 Contacts。 

ContactsContract. Data 表 存 储 了 联系 人 的 详细 信息 , 表 中 的 每 一 行 存储 一 个 特定 类 
型 的 信息 ,例如 E-mail、Address 或 Phone。 

ContactsContract. RawContacts 用 于 关联 联系 人 信息 与 账号 ,因为 有 可 能 手机 的 联 
系 人 信息 是 从 不 同 的 Gmail 或 者 其 他 地 方 导 入 的 ,为 互相 区 别 并 方便 同步 , 特 引入 账号 

ContactsContract. Contacts 表 中 的 一 行 表示 一 个 联系 人 , 它 是 RawContacts 表 中 的 
一 行 或 多 行 的 数据 的 组 合 ,这 些 RawContacts 表 中 的 行 表示 同一 个 人 的 不 同 的 账户 信 
息 。Contacts 中 的 数据 由 系统 组 合 RawContacts 表 中 的 数据 自动 生成 。 

代码 8. 8 实现 了 从 用 户 界面 获取 信息 ,然后 把 相应 的 信息 插入 通信 录 的 功能 。 因 为 
插入 涉及 Data、RawContacts 和 Contacts 三 个 表 , 所 以 使 用 批 处 理 来 执行 。 具 体 的 UI 界 
面 设计 与 实现 参见 第 2 章 的 知识 ,这 里 省 略 。 

代码 8.8 使 用 批 模式 操作 通信 录 


Protected void createContactEntry() { 

//Get values from UI 

String name= mContactNameFditText .getText () .toString(); 

String Fhone= mContactFhoneFditText .getText () .toString(); 

String email= mContactEmailEditText .getText () .toString(); 

int phoneType= mContact EhoneTypes.get ( 
TmContactFhoneTypeSpinner.getSelectedTtemPositicn ()) 7 

int emailType= mContactEmailTypes.get ( 
ContactEmai 1TypeSpinner .getSelectedItemposition());; 


ArrayList< ContentProviderOperation> ops= new 
ArrayList< ContentProviderOperation> ()7 


// 首 先 向 Rawcontacts.CONTENT URI 执行 一 个 插入 ， 
// 目 的 是 获取 系统 返回 的 rawcontactId 
cps.add (Content ProviderOperation.newInsert (RawContacts.OONIENT URI) 
.withValue (RawContacts.ROOCUNT TYFE, nSelectedPooamt.getType ()) 
.withValue (RawContacts.AOOOUNT NAME, 
mSelectedAcoount .getName ()) 
build(0)); 
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在 代码 8. 8 中 ,第 一 部 分 首先 从 UI 界面 获取 要 插入 记录 的 姓名 、 电 话 、E-mail、 电 话 
类 型 和 mail 类 型 ,然后 创建 新 的 ArrayList 对 象 ops。ops 变量 是 一 个 ContentProvider- 
Operation 数组 。 这 个 数组 用 来 存放 多 个 数据 库 操作 。 

如 果 要 想 完 成 一 个 操作 ,首先 调用 ContentProviderOperation 的 newInsert() 方 法 创 
建 一 个 构造 插入 语句 的 Builder 对 象 。 然 后 调用 Builder 中 的 withValue() 方 法 传人 要 插 
入 的 列 和 值 。 

ops 数组 一 共有 4 个 ContentProviderOperation 对 象 。 第 一 个 ContentProviderOperation 
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对 象 使 用 的 资源 标识 符 为 ContactsContract. RawContacts. CONTENT _URI, 这 个 资源 
表示 获得 联系 人 信息 的 账号 (可 以 保存 多 个 账号 的 联系 人 信息 ,例如 Gmail 本 地 电话 短 
等 ); 后 面 3 个 ContentProviderOperation 对 象 使 用 的 资源 标识 符 为 ContactsContract 
. Data. CONTENT_URI, 这 个 资源 表示 联系 人 的 元 数据 ,这 里 保存 了 联系 人 的 姓名 电话 
和 E-mail。 账 号 和 元 数据 之 间 具 有 父子 关系 ,就 是 如 果 删 除 账号 , 则 与 其 有 关联 的 元 数据 
都 要 被 删除 。 一 般 来 说 ,建立 这 种 关联 关系 的 方法 是 在 元 数据 资源 中 创建 指向 账号 资源 
主键 的 外 键 。 通 过 withValueBackReference ( ) 方 法 建立 这 种 关系 。withValue- 
BackReference() 有 两 个 参数 ,第 一 个 参数 是 字符 串 类 型 ,表示 子 表 外 键 列 名 ,第 二 参数 是 
int 类 型 ,表示 需要 关联 ops 数组 中 的 哪个 ContentProviderOperation 对 象 ,是 ops 数组 的 
索引 (从 0 开始 的 整数 ) 。 

ContentProviderOperation 对 象 中 还 包括 newAssertQuery ( )、newDelet ( ) 和 
newUpdate() 等 方法 ,它们 分 别 用 来 实现 查询 判定 (如 果 传 和 人 期望值, 可 以 判定 查询 结果 
与 期 望 值 是 否 相 等 )、 删 除 和 更 新 的 操作 。 一 旦 提供 了 所 有 的 参数 ,就 可 以 使 用 build( ) 方 
法 创建 ContentProviderOperation 对 象 。 

最 后 调用 getContentResolver(). applyBatch() 方 法 ,并 且 传 人 资源 名 称 和 操作 数组 
对 象 ops 执行 所 有 的 操作 。 
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Android 系统 预先 定义 了 一 些 ContentProvider, 其 中 包括 : 
Browser: 使 用 Browser ContentProvider 可 以 用 来 读 取 或 修改 标签 .浏览 历史 或 


者 网 络 搜索 。 
。 CallLog: 查看 或 更 新 电话 历史 ,包括 来 电 和 去 电 \ 未 接 来 电 和 电话 细节 ,如 联系 人 
和 通话 时 间 。 


Contacts: 使 用 ContactsProvider 可 以 用 来 读 取 .修改 或 保持 联系 人 信息 。 
MediaStore: MediaStore 提供 了 对 设备 上 的 多 媒体 文件 的 集中 控制 ,包括 音频 、 
视频 和 图 片 。 可 以 在 MediaStore 中 保存 自己 的 多 媒体 来 让 它 可 以 全 局 访问 。 
Settings: 可 以 使 用 SettingsProvider 来 访问 设备 的 Preference。 使 用 它 ,可 以 查 
看 和 修改 蓝牙 设置 .铃声 和 其 他 设备 设 定 。 


8.3 创建 ContentProvider 


前 面 两 节 介绍 了 ContentProvider 的 基础 和 数据 访问 ,如 果 要 定义 一 个 自己 的 
ContentProvider ,需要 实现 ContentProvider 类 ,并 在 manifest 文件 里 定义 相应 的 元 素 。 

但 是 创建 ContentProvider 是 一 个 比较 复杂 的 过 程 , 并 非 在 任何 情况 下 都 需要 创建 
ContentProvider。 在 构建 ContentProvider 之 前 ,需要 考虑 一 些 问题 ,判断 是 否 有 必要 创 
建 Provider。 例 如 ,需要 向 其 他 应 用 程序 提供 复杂 的 数据 或 文件 吗 ? 需要 复制 复杂 的 数 
据 给 其 他 应 用 程序 吗 ? 需要 通过 搜索 框架 提供 定制 的 搜索 建议 吗 ? 如 果 只 是 在 自己 的 应 
用 中 操作 SQLite 数据 库 , 则 不 需要 创建 ContentProvider, 如 果 其 他 应 用 程序 需要 操作 这 


Ne/ 基于 hndroid 平 台 的 移动 互联 网 开发 


部 分 数据 , 则 需要 创建 ContentProvider。 
831 设计 过 程 


下 面 是 建立 一 个 ContentProvider 的 基本 步骤 和 需要 使 用 的 API, 我 们 还 需要 定义 一 
个 Activity 来 测试 ContentProvider 数据 查询 和 操作 。 

1. 选择 储存 结构 

ContentProvider 是 一 个 操作 结构 化 数据 的 接口 。 在 创建 接口 之 前 ,需要 决定 如 何 储 
存 数据 。ContentProvider 可 以 通过 两 种 形式 保存 数据 。 一 种 是 使 用 文件 保存 ,数据 通常 
需要 写 和 文件 ,如 图 片 . 音 频 、 视 频 。 文 件 存储 在 应 用 程序 的 私有 空间 里 。 为 了 响应 其 他 
应 用 程序 的 请 求 ,ContentProvider 提供 数据 文件 的 句柄 。 还 有 一 种 是 使 用 关系 数据 库 ， 
数据 通常 存储 在 数据 库 、 数 组 或 相似 的 结构 中 ,它们 都 是 以 表 的 行列 形式 储存 数据 。 行 代 
表 一 个 实体 ,如 一 个 人 或 仓库 中 的 一 个 产品 。 而 列 代表 这 个 实体 的 数据 ,如 和 人名、 产品 的 
价格 。 在 Android 系统 中 ,这 种 类 型 的 数据 通常 是 储存 在 SQLite 数据 库 里 。 在 创建 
ContentProvider 时 ,可 以 根据 所 存储 的 数据 类 型 和 数据 服务 ,选择 适当 的 数据 存储 类 型 。 

如 果 选 择 使 用 文件 存储 数据 ,Android 系统 提供 了 一 系列 有 关 文 件 操作 的 API。 如 
果 ContentProvider 预备 提供 的 数据 是 位 图 文件 或 其 他 类 型 面向 文件 的 数据 ,比较 适合 把 
数据 存储 在 一 个 文件 里 并 且 直 接 提供 ,而 不 是 通过 表 提 供 。 其 他 应 用 程序 在 使 用 这 些 数 
据 时 ,需要 使 用 ContentResolver 文件 方法 来 访问 。 

如 果 选 择 使 用 关系 数据 库存 储 数据 ,Android 系统 提供 了 包含 操作 SQLite 数据 库 的 
API,Android 系统 中 预定 义 的 ContentProvider 就 是 使 用 关系 数据 库 保 存 数据 。 
SQLiteOpenHelper 是 创建 数据 库 的 帮助 类 ,SQLiteDatabase 是 访问 数据 库 的 基 类 。 虽 
然 ContentProvider 对 外 的 表现 类 似 于 关系 数据 库 , 但 是 这 对 于 ContentProvider 的 内 部 
实现 来 说 并 不 是 必需 的 。 为 了 处 理 基 于 网 络 的 数据 ,还 可 以 使 用 java. net 和 android. net 
里 的 API, 把 基于 网 络 的 数据 同步 到 本 地 数据 存储 中 ,并且 以 表 或 文件 的 形式 提供 数据 。 

选择 了 数据 的 存储 方式 之 后 ,一 个 重要 的 工作 就 是 设计 ContentProvider 表 的 数据 结 
构 。 虽 然 主键 对 于 一 个 ContentProvider 并 不 是 必须 具备 的 ,即使 有 主键 ， 
ContentProvider 也 一 定 要 使 用 _ID 作为 主键 的 列 名 。 但 是 ,如 果 要 把 ContentProvider 
中 的 数据 通过 用 户 界 面 显示 出 来 ,常常 需要 把 ContentProvider 绑 定 到 一 个 叫 作 
ListView 的 用 户 界面 控件 上 ,这 就 必须 有 一 个 列 名 叫做 _ID。 

在 ContentProvider 支持 的 数据 类 型 中 ,Binary Large OBject (BLOB) 数 据 类 型 用 于 
存储 大 小 变化 或 数据 结构 变化 的 数据 。 例 如 ,可 以 使 用 一 个 BLOB 列 来 储存 量 一 个 
protocol buffer 或 JSON structure。 对 于 这 种 类 型 的 数据 ,可 以 使 用 BLOB 来 实现 一 个 
独立 模式 的 表 , 定 义 一 个 主键 和 一 个 MIME 类 型 的 列 , 其 他 列 定义 为 BLOB,BLOB 列 里 
的 数据 意义 由 MIME 列 来 指定 。 这 样 就 可 以 在 同一 张 表 里 存储 不 同 的 数据 类 型 。 

2. 定义 资源 标识 笃 

每 一 个 ContentProvider 都 使 用 资源 标识 符 Content URI 来 指定 其 中 的 数据 。 通 过 
资源 标识 符 ,不 仅 可 以 唯一 确定 提供 数据 的 ContentProvider, 还 可 以 通过 其 中 的 路 径 来 
指定 ContentProvider 中 的 表 , 甚 至 可 以 使 用 ID 确切 地 访问 指定 表 中 的 唯一 行 。 而 且 
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ContentProvider 中 的 每 个 方法 都 有 一 个 资源 标识 符 作 为 参数 ,可 以 用 来 确定 需要 访问 的 
表 \、 行 和 文件 。 因 此 定义 资源 标识 符 是 创建 ContentProvider 很 重要 的 部 分 。 

定义 资源 标识 符 主要 考虑 下 面 几 个 问题 。 

(1) ContentProvider 资源 名 的 定义 。 

在 Android 系统 中 ,ContentProvider 应 该 具有 唯一 的 资源 名 ,作为 其 在 Android 里 
的 内 部 名 。 为 了 避免 资源 名 的 重复 ,资源 名 通常 采用 域名 的 格式 。 由 于 应 用 程序 的 包 
名 也 是 按照 这 种 格式 设计 的 ,因此 ,可 以 通过 扩展 包 名 的 方式 定义 资源 名 。 例 如 ,应 用 
程序 的 包 名 为 com. example. 一 appname 二 ,那么 资源 名 称 就 可 以 定义 为 com. example 
. appname>. provider。 

(2) 资源 标识 符 的 路 径 结构 。 

开发 人 员 通 常 从 资源 名 开始 ,在 后 面 追加 路 径 来 指向 具体 的 表 。 例 如 ,在 provider 中 
设计 了 两 张 表 tablel 和 table2, 就 可 以 使 用 下 面 的 路 径 结构 来 指定 对 应 的 资源 : com 
. example. < appname >. provider/tablel 和 com. example. < appname >. provider/ 
table2。 路 径 可 以 有 多 个 层次 ,不 一 定 每 个 层次 都 指向 表 。 

(3) 处 理 资源 标识 符 中 的 ID。 

按照 约定 ,通过 使 用 带 有 ID 值 的 资源 标识 符 可 以 访问 表 中 指定 的 一 行 。 这 个 ID 在 
资源 标识 符 的 末尾 。 一 般 来 说 ,ContentProvider 的 ID 值 与 表 中 的 _ID 值 匹配 ,可 以 用 来 
操作 对 应 的 数据 行 。 当 应 用 程序 访问 ContentProvider 时 ,这 个 约定 是 一 个 通用 的 设计 模 
式 。 应 用 程序 从 ContentProvider 中 查询 数据 返回 游标 对 象 ,并 且 利 用 CursorAdapter 在 
ListView 中 显示 结果 。 定 义 CursorAdapter 时 ,需要 游标 中 有 一 列 为 _ID。 如 果 用 户 选 
取 了 ListView 中 的 一 行 ,希望 可 以 查询 或 者 修改 对 应 的 数据 。 这 就 需要 应 用 程序 从 
ListView 的 后 台 游 标 中 得 到 这 行 _ID 值 , 然 后 附加 到 资源 标识 符 的 后 面 , 然 后 发 送 访 问 请 
求 给 ContentProvider, 这 样 来 完成 对 某 一 行 数据 的 查询 或 修改 。 

3. 资源 标识 符 模式 

不 同 资源 标识 符 的 模式 对 应 不 同 的 操作 ,所 以 需要 识别 不 同 资源 标识 符 的 模式 。 
Android 的 API 中 包含 一 个 UriMatcher 类 .用 来 定义 不 同 资源 标识 符 的 匹配 模式 。 这 个 
类 把 资源 标识 符 的 模式 映射 到 一 个 整数 ,这 样 应 用 程序 在 switch 语句 中 可 以 匹配 对 应 整 
数 来 选择 对 应 的 操作 。 在 做 匹配 的 过 程 中 ,资源 标识 符 模 式 使 用 了 通配符 ,其 中 “x* ”匹配 
一 个 字符 串 , 可 以 任何 长 度 的 任何 值 ;*# ”匹配 一 个 字符 串 , 可 以 是 任何 长 度 的 数字 。 

下 面 举例 设计 一 组 资源 标识 符 , 并 且 通 过 编码 处 理 资 源 标识 符 。 

假定 有 一 个 ContentProvider 的 资源 名 为 com. example. app. provider, 下 面 的 资源 标 
识 符 则 指向 具体 的 表 : 


content://com.example.app.provider/tablel: A table called tablel 
content://com.exzample.app.Provider/table2/dataset]1: A table called datasetl 
ontent://om.exanple.arp.provider/table?/dataset?: A table called dataset2 
content://com-example-app-provider/table3: A table called table3 


如 果 在 上 述 的 资源 标识 符 后 面 加 上 ID, 例 如 content://com. example. app. provider/ 
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table3/1 则 表示 表 table3 中 主键 为 1 的 行 。 对 于 com. example. app. provider 来 说 ,以 下 
的 资源 标识 符 的 模式 都 是 可 用 的 : 

(1) content://com. example. app. provider/ * : 表示 匹配 provider 的 任何 任何 资源 
标识 符 。 

(2) content://com. example. app. provider/table2/* : 表示 匹配 datasetl 和 
dataset2 的 资源 标识 符 ,不 匹配 表 tablel 或 table3 的 资源 标识 符 。 

(3) content://com. example. app. provider/table3/# : 表示 匹配 table3 中 某 行 的 资 
源 标识 符 。 

代码 8. 9 示例 了 UriMatcher 的 方法 如 何 完成 模式 的 匹配 。 这 段 代 码 中 ,针对 表 的 资 
源 标 识 符 与 单行 的 资源 标识 符 实现 了 不 同 的 处 理 方式 ,其 中 定义 content:// 氨 authority 之 / 
二 path 志 模式 为 表 , 定 义 content:// 一 authority 二 /二 path>/ 志 id 这 模式 为 单行 。 

UriMatcher 的 addURI() 方 法 把 资源 名 和 路 径 映射 到 一 个 整数 。match( ) 方 法 返回 
了 对 应 资源 标识 符 的 整数 。 然 后 通过 一 个 switch 语句 根据 不 同 整数 来 对 应 不 同 的 模式 ， 
选择 查询 表 或 者 单个 记录 。 

addURI() 方 法 的 参数 说 明 如 下 。 

(1) String authority: Content URI 的 authority 部 分 ,也 就 是 资源 名 。 

(2) tring path: Content URI 的 path 部 分 ,详细 的 表 或 记录 路 径 。 

(3) int code: 模式 对 应 整数 。 

代码 8.9 定义 和 使 用 资源 标识 符 模式 


Public class ExampleProvider extends ContentProvider { 
/定义 常量 
private static final int PEOPIE= 1; 
Private static final int PEOPIE ID=2; 
private static final int PEOPIE PHONES= 3; 
private static final int PEOPIE PHONES ID=4; 
Private static final int PEOPLE ONTACIMETHODS= 7; 
private static final int PEOPIE CONTRCTMETHODS ID=8; 


Private static final int [ELETED PEOPLE= 20; 
Private static final int PHNES= 9; 
Private static final int PHONES ID=10; 


Private static final int PHONES FILTER=14; 


Private static final int ONTACIMETHODS= 18; 
Private static final int ONTIACIMETHODS ID=19; 


Private static final int CALLS= 11; 
Private static final int CALLS ID= 12; 
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IEturn mull; 


上 


另外 ,ContentUris 类 提供 了 处 理 资源 标识 符 中 id 部 分 的 方法 ,Uri 和 Uri. Builder 类 
中 包含 解析 Uri 对 象 ,或 者 构建 新 对 象 的 方法 。 

4. 定义 Contract 类 

Contract 类 , 即 合约 类 ,是 一 个 final public 的 类 ,主要 用 于 定义 provider 使 用 的 常 
量 , 例 如 资源 标识 符 、 表 名 、 列 名 、MIME 类 型 和 其 他 一 些 媒体 数据 等 。Contract 类 在 
provider 和 其 他 应 用 程序 之 间 建 立 了 一 个 契约 ,保证 provider 的 数据 资源 能 够 被 这 些 程 
序 正确 访问 。 这 样 ,即使 provider 中 的 这 些 常量 中 的 值 有 变化 ,也 不 会 影响 外 部 程序 的 
使 用 。 

由 于 Contract 类 通常 使 用 带 有 语义 的 名 字 来 命名 常量 ,可 以 帮助 开发 人 员 减 少 使 用 
列 名 或 资源 标识 符 的 错误 。 而 且 还 可 以 包含 文档 ,集成 开发 环境 (例如 Eclipse) 可 以 帮助 
开发 人 员 选 取 常 量 名 ,并 且 显示 相关 文档 。 

外 部 程序 的 开发 者 从 应 用 程序 中 不 能 访问 Contract 类 的 class 文件 ,但 在 编译 时 ,可 
以 静态 编译 到 应 用 程序 中 。 

5. 定义 MIME 类 型 

ContentProvider 类 有 两 个 方法 返回 MIME 类 型 。 一 个 是 getType() ,这 是 必须 实现 
的 方法 。 另 一 个 为 getStreamTypes() ,如 果 provider 提供 文件 类 型 数据 ,就 需要 实现 这 
个 方法 。 

getType() 方 法 返回 一 个 MIME 格式 的 字符 串 , 这 个 字符 串 描 述 了 资源 标识 符 参数 
对 应 的 数据 类 型 。 资 源 标识 符 参数 可 以 是 一 个 具体 的 标识 符 , 也 可 以 是 一 个 模式 。 如 果 
参数 为 模式 , 则 需要 返回 与 这 种 模式 相 匹 配 的 资源 标识 符 关 联 的 数据 类 型 。 

如 果 是 通常 的 数据 类 型 ,例如 text.HTML 或 者 JPEG,getType() 方 法 返回 标准 的 
MIME 类 型 。 这 些 类 型 可 从 官方 的 网 站 (http://www. iana. org/assignments/media- 
types) 上 查找 。 

如 果 是 表 中 一 行 或 多 行 数据 类 型 ,getType() 方 法 返回 Android 特定 的 MIME 格式 : 

(1) type 部 分 : vnd。 

(2) 子 类 型 部 分 : 

单行 的 URI 模式: android. cursor. item/。 

多 行 的 URI 模式 : android. cursor. dir/。 

(3) Provider 说 明 的 部 分 : vnd. 二 name 二 . 过 type 记 。 

其 中 name 值 必须 是 全 局 唯一 的 ,type 值 必须 对 应 一 个 资源 标识 符 的 模式 。name 可 
以 选择 公司 的 名 字 或 应 用 程序 包 的 部 分 名 字 。Type 最 好 标识 可 以 关联 资源 标识 的 表 。 

例如 ,provider 的 资源 名 为 com. example. app. provider, 表 名 是 tablel , 则 表示 tablel 
表 里 多 行 数 据 的 MIME 类 型 是 ， 
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vpnd.android.cursor.dir/vnd.com-example.-Provider.tablel 
如 果 表示 tablel 表 的 单行 ,MIME 类 型 是 : 
vnd.android.cursor.item/vnd.om.exanple.provider.tablel 


如 果 provider 支持 的 是 文件 类 型 数据 ,需要 实现 getStreamTypes() 方 法 。 这 个 方法 
会 根据 资源 标识 符 参数 从 provider 中 返回 包含 MIME 类 型 的 字符 串 数组 。 可 以 通过 参 
数 来 过 滤 MIME 类 型 , 仅 返回 客户 端 可 以 处 理 的 MIME 类 型 。 

例如 ,假定 provider 支持 . jpg、. png 和 . gif 格式 的 图 片 文件 。 当 应 用 程序 调用 
Content-Resolver. getStreamTypes() 方 法 时 ,如 果 使 用 过 滤 字 符 串 image/ * ,表示 这 是 
一 张 图 片 ,ContentProvider. getStreamTypes() 方 法 返回 的 数组 内 容 为 {"image/jpeg"， 
"image/png", "image/gif"} ,如 果 应 用 程序 仅仅 需要 文件 . jpg, 调 用 ContentResolver 
. getStreamTypes( ) 方 法 的 时 候 使 用 过 滤 字 符 串 x* /jpeg, 则 返回 的 结果 为 {"image/ 
jpeg"}。 如 果 provider 中 没有 支持 过 滤 字 符 串 的 MIME 类 型 ,getStreamTypes() 方 法 返 
回 null。 

6. 实现 ContentProvider 的 子 类 

定义 自己 的 ContentProvider, 需 要 创建 ContentProvider 的 子 类 ,使 用 ContentProvider 
实例 来 处 理 其 他 应 用 的 访问 请 求 , 并 且 管 理 结构 化 数据 的 访问 。 所 有 对 provider 数据 的 
访问 ,都 通过 所 创建 ContentResolver 对 象 , 调 用 操作 数据 的 方法 ,最 终 调 用 ContentProvider 
中 的 具体 方法 来 实现 。 

因此 ,在 子 类 里 需要 代码 实现 ContentProvider 提供 六 个 抽象 方法 ,具体 来 完成 对 
provider 的 数据 操作 。 这 6 个 抽象 方法 包括 query() insert()、update() delete()、 
getType() 和 oncreate() 。 除 了 onCreate() ,其 他 方法 都 会 被 访问 ContentProvider 的 客 
户 端 应 用 程序 调用 。 

(1) query() : 用 来 从 provider 获取 数据 。 通 过 参数 来 选择 查询 的 表 、 返 回 行 或 列 、 结 
果 排 序 。 方 法 的 查询 结果 返回 游标 对 象 。 如 果 使 用 SQLite 数据 库存 储 数 据 , 可 以 使 用 
SQLiteDatabase 类 的 query() 方 法 来 返回 游标 对 象 。 如 果 没 有 匹配 的 行 ,也 返回 游标 对 
象 .但 是 其 getCount() 方 法 返回 值 为 0。 如 果 在 查询 中 出 现 内 部 错误 ,将 返回 null。 如 果 
没有 使 用 SQLite 数据 库 保 存 数据 ,可 以 使 用 一 个 Cursor 类 的 具体 子 类 。 例 如 ， 
MatrixCursor 类 实现 了 游标 的 功能 ,其 中 每 行 数据 是 数组 ,可 以 使 用 addRow() 方 法 添加 
新 行 。 

另外 ,由 于 用 户 程序 访问 ContentProvider 是 跨 进 程 通信 ,所 以 在 进程 间 传递 异常 信 
息 是 非常 重要 的 。IllegalArgumentException 和 NullPointerException 对 于 处 理 这 类 查 
询 异 常 是 非常 有 帮助 。 

(2) insert(): 用 来 向 ContentProvider 插入 新 行 。insert() 方 法 使 用 URI 参数 确定 
要 插入 行 的 表 , 向 合适 的 表 里 添 加 行 ,使 用 ContentValues 对 象 为 列 设 置 值 。 如 果 
ContentValues 里 没有 行 名 ,ContentProvider 使 用 代码 里 或 者 数据 库 框架 里 的 默认 值 。 
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这 个 方法 返回 新 行 的 资源 标识 符 。 使 用 withAppendedId() 方 法 将 新 行 的 _.ID( 或 其 
他 主键 ) 附 加 到 表 的 资源 标识 符 后 面 。 

(3) delete(): 用 来 删除 行 。 使 用 参数 选择 删除 的 表 和 行 ,返回 结果 为 删除 的 行 数 。 
delete() 方 法 没有 必要 物理 地 删除 行 。 

(4) update(): 用 来 更 新 存在 的 行 。 使 用 参数 选择 需要 更 新 的 表 和 行 ,然后 更 新 其 中 
列 的 值 , 返回 结果 为 更 新 的 行 数 。update ( ) 方 法 使 用 同 insert () 方 法 相同 的 
ContentValues 参数 , 同 delete() 和 query() 方 法 使 用 相同 的 selection 和 selectionArgs 参 
数 。 这 样 就 可 以 允许 在 这 些 方法 之 前 使 用 相同 的 代码 。 

(5) onCreate(): 初始 化 ContentProvider。Android 系统 在 创建 ContentProvider 之 
后 就 立即 调用 这 个 方法 。 注 意 直到 ContentResolver 对 象 需要 访问 时 ,ContentProvider 
才 创 建 。 

由 于 Android 系统 在 ContentProvider 启动 的 时 候 调 用 onCreate() ,因此 onCreate() 
方法 不 能 有 耗 时 太 多 的 代码 ,避免 延迟 数据 库 的 创建 和 数据 加 载 。 如 果 在 onCreate() 里 
有 耗 时 太 多 的 任务 ,会 减 慢 ContentProvider 的 启动 ,也 就 会 减 慢 其 对 其 他 应 用 程序 的 
响应 。 

下 面 一 个 例子 ,说 明 如 何 实现 ContentProvider 的 这 些 方法 。 这 个 例子 实现 了 在 方法 
ContentProvider. onCreate() 里 创建 一 个 新 的 SQLiteOpenHelper 对 象 来 使 用 数据 库 , 在 
打开 数据 库 的 时 候 创 建 表 。 这 样 ,第 一 次 调用 getWritableDatabase() 时 ,会 自动 调用 方 
法 SQLiteOpenHelper. onCreate() 。 代 码 8. 10 实现 ContentProvider. onCreate() 方 法 。 

代码 8. 10 ”实现 ContentProvider. onCreate() 方 法 


//Defines a handle to the database helper cbject 
Private MainDatabaseHelper mOpenHelper; 


//Defines the database name 
private static final String TENBME= "mydb"; 


//Holds the database cbject 
Private SQLiteDatabase dpb; 


Public boolean onCreate() { 


/¥ 
¥* Creates a new helper dbject. This method always retums quickly 
* Notioe that the database itself isn't created or cpened 
* intil SQLiteQpenHelper.getWritableDatabase is called 
二 
mopenHelper— new SQLiteOpenHelper( 
getContest (), //the applicaticn context 
TENRME， //the name of the database) 
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/¥* 
# Creates the data repository. This is called when the provider attempts to open the 
* repository and SQLite reports that it doesn't exist 
入 

Public void onCreate (SQLiteDatabase db) { 


//Creates the main table 
db.execSQL(SQL CREATE MAIN); 


} 


通过 这 个 例子 可 以 看 出 , ContentProvider. onCreate ( ) 和 SQLiteOpenHelper 
.onCreate() 的 相互 调用 。 在 实现 ContentProvider 的 抽象 方法 时 ,除了 onCreate() 外 , 需 
要 考虑 线程 安全 。 

7. 定义 访问 权限 

针对 不 同类 型 的 存储 方式 , Android 系统 的 存储 安全 和 有 效 的 权限 的 要 点 有 下 面 
几 个 。 

。 默认 情况 下 ,在 内 部 存储 的 数据 文件 对 其 应 用 程序 和 ContentProvider 是 私有 的 。 

。 外 部 存储 的 数据 文件 是 公开 的 。 无 法 使 用 ContentProvider 限制 其 他 程序 访问 外 
部 存储 中 的 文件 ,其 他 应 用 程序 可 以 使 用 API 读 写 它们 。 
在 内 部 存储 的 文件 或 是 SQLite 数据 库 , 可 以 由 创建 其 的 应 用 程序 潜在 地 把 读 和 
写 的 权限 赋 给 其 他 的 应 用 程序 。 如 果 要 使 用 内 部 文件 或 数据 库 作为 
ContentProvider 的 数据 源 ,必须 在 manifest 文件 中 设置 权限 ,把 其 访问 权限 设 为 
world-readable 或 world-writeable, 这 些 数据 将 不 再 受到 保护 。 默 认 情 况 下 内 部 
储 器 文件 和 数据 库 的 访问 权限 是 private, 对 于 ContentProvider 也 不 应 该 改变 。 

如 果 要 用 ContentProvider 的 权限 来 控制 对 数据 的 访问 ,就 应 该 将 数据 存储 在 内 部 文 
件 ,SQLite 数据 库 , 或 “ 云 "( 例 如 ,在 远程 服务 器 上 ) 的 数据 中 ,并 保持 文件 和 数据 库 的 
private 存储 访问 权限 。 

怎样 进行 ContentProvider 的 权限 控制 呢 ? 

如 果 不 做 任何 权限 设置 ,所 有 的 应 用 程序 可 以 读 取 或 写 和 人 ContentProvider, 即 使 这 
些 数据 的 存储 访问 权限 是 私有 的 。 因 为 默认 情况 下 ContentProvider 没有 权限 集 。 
ContentProvider 的 权限 集 需 要 在 manifest 中 ,使 用 ContentProvider 的 属性 和 子 元 素来 
设置 。 在 这 里 可 以 设置 应 用 于 整个 ContentProvider、 特 定 的 表 、 单 一 的 记录 或 满足 某 些 
条 件 权 限 。 

在 manifest 文件 中 ,可 以 使 用 一 permission 二 元 素 为 ContentProvider 定义 一 个 或 多 
个 访问 权限 。 为 了 这 些 权限 的 唯一 性 ,可 以 用 Java 包 名 的 方式 定义 android:name 属性 。 
例如 ,指定 读 权 限 的 com. example. app. provider. permission. READ_PROVIDER。 

下 面 是 ContentProvider 数据 范围 由 大 到 小 的 权限 设置 。 

。 读 写 ContentProvider 级 别 的 权限 。 
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控制 整个 ContentProvider 的 读 写 权 限 , 使 用 二 provider 二 元 素 的 android: 
permission 属性 指定 。 

。 读 或 写 ContentProvider 级 别 的 权限 。 

控制 整个 ContentProvider 的 读 权 限 或 写 权 限 。 使 用 二 provider 二 元 素 的 android: 
readPermission 属性 或 android:writePermission 属性 来 设 定 。 

。 路 径 级 别 权 限 。 

对 于 ContentProvider 中 的 Content URI 指定 数据 的 读 、 写 或 读 / 写 权限 。 使 用 
一 provider> 的 子 元 素 二 path-permission 二 来 指定 要 控制 的 每 个 URI 数据 的 访问 权限 。 
在 权限 设置 时 ,可 以 针对 每 个 Content URI, 指 定 一 个 读 / 写 权限 、 读 权限 或 写 权 限 , 或 所 
有 三 个 权限 。 其 中 读 取 和 写 和 人 权限 覆盖 读 / 写 权限 ,并 且 路 径 级 别 的 权限 覆盖 provider 级 
别 的 权限 。 

。 临时 权限 。 

对 于 临时 访问 的 应 用 程序 指定 的 权限 ,这 个 权限 也 适用 于 通常 没有 所 需 权 限 的 应 用 
程序 。 临 时 访问 功能 减少 了 应 用 程序 在 其 manifest 中 请 求 权 限 的 数量 。 使 用 元 素 的 
android:grantUriPermissions 属性 ,或 者 二 provider 二 的 子 元 素 志 grantruri-permission 过 
来 设置 临时 权限 。 如 果 使 用 临时 权限 ,无论 什 么 时 候 从 provider 中 删除 Content URI 数 
据 ,都 必须 调用 Context. revokeUriPermission( ) 方 法 ,因为 这 个 Content URI 拥有 临时 
权限 。 如 果 android:grantUriPermissions 属性 没有 设置 ,默认 就 是 false。 

与 Activity 和 Service 组 件 一 样 , ContentProvider 的 子 类 也 必须 在 其 应 用 程序 的 
manifest 文件 中 进行 声明 ,才能 够 在 系统 中 起 作用 。 在 manifest 文件 中 声明 
ContentProvider 的 元 素 为 二 provider 二 ,使 用 android:name 说 明 ContentProvider 的 名 
称 。 除 了 前 面 所 提 到 的 访问 权限 的 属性 和 元 素 , 还 包括 其 他 属性 。 
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上 面 介 绍 了 ContentProvider 设计 和 创建 的 方法 ,下 面 一 个 ContentProvider 的 实例 。 

1. 创建 ContentProvider 

为 了 更 好 地 理解 设计 Provider 的 原则 ,我 们 用 一 个 完整 的 例子 来 讲解 创建 一 个 
Provider 的 过 程 。 

这 个 例子 的 ContentProvider 创建 ,是 基于 上 一 章 的 SOLite 学 生 信息 数据 库 , 这 个 数 
据 库 包括 两 张 表 students 和 departments, 这 两 个 表 之 间 有 外 键 约束 。 下 面 按照 前 一 节 
的 设计 过 程 ,逐步 完成 ContentProvider 的 创建 。 

(1) 选择 存储 结构 : 选择 SQLite 数据 库 。 

(2) 定义 资源 标识 符 : 根据 前 一 章 SQLite 数据 库 中 定义 的 数据 表 , 和 自己 定义 的 前 
组 定义 所 要 创建 的 provider 的 Content URI 如 下 : 


content://com.pinecone-technology-studentprovider/students 
content://com.pinecone.technology.studentprovider/deparbmnents 


这 个 定义 在 Contract 类 中 实现 。 
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(3) 定义 资源 标识 符 模式 : 在 ContentProvider 类 内 代码 的 第 一 部 分 定义 资源 标识 
符 模 式 ,前 一 部 分 是 常量 定义 ,后 一 部 分 模式 定义 ( 见 代码 8. 11)。 
代码 8.11 定义 资源 标识 符 模式 


(4) 定义 Contract 类 : 根据 ContentProvider 的 需要 ,定义 一 些 常量 ,例如 Content 
URI、 表 名 和 列 名 ( 见 代码 8. 12)。 
代码 8.12 StudentsContract. java 
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(5) 定义 MIME 类 型 : 对 应 这 个 例子 的 两 个 表 ,定义 如 下 4 个 MIME 类 型 。 


这 4 个 MIME 类 型 在 StudentsContract 类 中 定义 为 常量 ( 见 代码 8. 12) 。 

(6) 定义 ContentProvider: 要 定义 ContentProvider 的 子 类 StudentsProvider, 首 先 定 
义 资源 标识 符 模式 ,然后 具体 实现 ContentProvider 的 6 个 抽象 方法 ,onCreate()、 
insert() ,update() .delete() ,query() 和 getType()( 见 代码 8. 13) 。 
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代码 8.13 StudentsProvider. java 
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(7) 定义 访问 权限 。ContentProvider 的 访问 权限 在 manifest 文件 中 声明 二 provider 二 时 
定义 。 默 认 状态 下 ,所 有 的 其 他 应 用 程序 都 可 以 访问 这 个 ContentProvider。 

2. 注册 ContentProvider 

最 后 我 们 要 在 manifest 文件 中 注册 ContentProvider: 


8.4 实现 数据 加 载 


在 前 面 的 章节 ,查看 数据 库 的 查询 结果 或 Provider 提供 的 数据 时 ,每 次 查询 的 结果 
并 不 确定 ,需要 实现 数据 的 动态 加 载 。Android 针对 这 一 类 的 数据 提供 了 一 个 机 制 , 叫 数 
据 绑 定 。 通 过 数据 绑 定 , 可 以 把 动态 的 数据 与 称 为 AdapterView 的 图 形 控件 连接 起 来 ， 
并 自动 根据 数据 的 内 容 进行 布局 调整 ,按照 某 种 规则 显示 给 用 户 。 在 数据 源 (data 
source) 和 AdapterView 之 间 起 连接 作用 的 类 ,在 Android 系统 中 称 为 适配器 。 

当 想 用 合适 的 方式 显示 并 操作 一 些 数据 (如 数组 、 链 表 、 数 据 库 等 ) 的 时 候 , 可 以 使 用 
提供 Android 适配器 视图 (AdapterView) ,这 种 方式 叫 数据 绑 定 ( 见 图 8. 2) 。 
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AdapterView 上 = 一 让 适配器 上 一 数据 源 


图 8.2 数据 绑 定 


适配器 就 相当 于 一 个 通道 ,加 了 一 些 规则 的 通道 , 它 可 以 使 得 流 过 通道 的 数据 按照 某 
种 规则 呈现 出 来 。 适 配器 是 数据 与 数据 显示 控件 (如 ListView、Gallery、Spinner) 之 间 的 
桥梁 ,用 来 将 数据 绑 定 到 显示 控件 上 进行 显示 。 比 如 说 ,USB 是 一 个 适配器 , 它 有 一 些 读 
取 数 据 的 规则 ,如 果 插 入 鼠标 , 则 系统 会 通过 USB 获取 的 信息 识别 是 鼠标 ,系统 可 以 对 鼠 
标的 操作 做 出 反应 ;如 果 是 U 盘 系 统 会 通过 USB 获取 的 信息 识别 是 U 盘 , 可 以 对 它 进 行 
信息 存 取 操 作 。 这 里 的 USB 就 相当 于 适配器 ,鼠标 或 U 盘 的 信息 ,就 是 系统 通过 适配器 
获取 的 数据 。 同 样 的 道理 ,通过 Android 适配器 的 作用 ,Android 系统 会 识别 出 是 数组 还 
是 数据 库 的 数据 ,并 根据 适配器 传递 的 信息 做 出 合适 的 显示 。 

Android 提供 多 种 适配器 ,开发 时 可 以 针对 数据 源 的 不 同 采用 最 方便 的 适配器 ,也 可 
以 自 定义 适配器 完成 复杂 功能 。 使 用 这 种 机 制 ,就 可 以 把 前 面 Provider 的 数据 从 用 户 界 
面 上 显示 出 来 。 

下 面 ,首先 介绍 数据 绑 定 的 基本 原理 ,然后 介绍 适合 数据 库 数据 显示 的 ListView 图 
形 控件 。 
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AdapterView 是 ViewGroup 的 子 类 ,其 中 画廊 (Gallery) 、 列 表 视 图 (ListView) 、 微 调 
框 控件 (Spinner) 和 网 格 视图 (GridView) 等 都 是 适配器 视图 AdapterView 子 类 的 例子 ， 
用 来 绑 定 到 特定 类 型 的 数据 并 以 一 定 的 方式 显示 。AdapterView 对 象 有 两 个 主要 责任 : 

(1) 用 数据 填充 布局 。 

(2) 响应 用 户 的 选择 事件 。 

常见 的 适配器 有 SimpleAdapter、SimpleCursorAdapter、ArrayAdapter。 从 名 称 可 以 
看 出 ,ArrayAdapter 使 用 数组 作为 数据 源 ,SimpleCursorAdapter 使 用 游标 作为 数据 源 ， 
而 SimpleAdapter 将 一 个 List 作为 数据 源 ,可 以 让 ListView 进行 更 加 个 性 化 的 显示 。 

下 面 使 用 Android 下 拉 菜 单 Spinner 控件 ,来 举例 说 明 数 据 绑 定 的 机 制 。 

1. 设置 应 用 的 布局 文件 

首先 设计 用 户 图 形 界 面 的 布局 文件 ,把 显示 数据 结果 的 Spinner 控件 作为 界面 中 的 
一 个 组 件 ( 见 代码 8. 14) 。 

代码 8.14 布局 文件 c07_spinner. xml 


< ?aml version= 叫 .0" encoding= "utf- 8"2> 
<IinearLayout Xmlns:androidF "http://schemas.android.coryapkyres/androidq" 
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android:layout width= "fill Parentn 
android:layout height= "wrap contentn 
android: layout marginTop= "10dip" 
android:text= "@ string/planet prompt"/> 


< Spinner 
android:id= "@ + id/spinner”" 
android:layout widthr "fill parent" 
android: layout. height= "wrap content" 
android:drawSelectoronTop= "truen 
android:promptr "@ string/planet. Prompt"/> 


< /LinearIayout> 


2. 在 Activity 中 获得 Spinner 控件 对 象 
在 定义 用 户 界面 的 Activity 子 类 中 ,通过 布局 文件 代码 8. 14 中 所 定义 的 Spinner 的 
id, 在 onCreate() 方 法 中 使 用 findViewById() 获 取 Spinner 对 象 。 代 码 如 下 : 


setContentView (R.layout.c07 spinner); 
Spinner s= (Spinner) findViewById(R.id.spinner); 


3. 实现 Spinner 与 数据 源 的 数据 绑 定 

获取 Spinner 对 象 后 ,在 此 Activity 子 类 的 onCreate() 方 法 内 实现 数据 绑 定 。 

首先 为 Spinner 控件 创建 适配器 ,获得 arrays. xml 资源 文件 中 数组 planets; 接 下 来 
将 数据 显示 界面 声明 为 android. R. layout. simple_spinner_item 布局 模式 ,将 此 适配器 与 
控件 对 象 绑 定 。 这 个 模式 是 为 Spinner 类 预定 义 好 的 布局 模式 。 然 后 创建 下 拉 菜 单 ( 见 
代码 8. 15) 。 

适配器 ArrayAdapter 是 适用 于 数组 数据 的 适配器 ,用 外 部 数据 创建 一 个 适配器 对 象 
可 以 使 用 其 createFromResource() 方 法 。 其 参数 说 明 如 下 : 

。 Context context: 应 用 程序 的 环境 。 

。 int textArrayResId: 作为 数据 源 的 数组 。 

。 int textViewResId: 用 于 创建 视图 的 布局 模式 。 

创建 下 拉 菜 单 使 用 ArrayAdapter 的 setDropDownViewResource() 方 法 ,其 参数 说 
明 如 下 。 

。 int resource: 布局 资源 定义 的 下 拉 菜 单 视图 。 

代码 8.15 创建 适配器 


Arrayhdapter< CharSecquence> adapter= Arrayhdapter .createF rarResouroe (this, 
R.array.planets, android.R.layout.simple spinner item); 

adapter .setDropDownViewResouroe (android.R.layout.simple spinner dropdown item); 

3.setAhdapter (adapter); 
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4. 定义 数据 源 数 组 
在 资源 文件 arrays. xml 文件 中 定义 数组 Planets ,并 设置 数组 值 ( 见 代码 8. 16) 。 
代码 8.16 arrays. xml 


<Iesources> 

< string name= "app name"> Spinner< /string> 
< string- array name= "planets"> 

< item> Mercury< /item> 

< item> Venus< /item> 

< item> Earth< /item> 

< item> Mars< /item> 

< item> Jupiter< /item> 

< item> Saturn< /item> 

< item> Uranus< /item> 

< item> Neptune< /item> 

< item> Pluto< /item> 

< /string- array> 

< string name= "planet. prompt"> Select a planet< /string> 
< /resouroes> 


运行 这 个 例子 程序 ,就 得 到 图 8. 3 显示 的 界面 。 这 里 的 数据 源 ,也 就 是 arrays 中 定 
义 的 planets 数组 ,通过 ArrayAdapter 这 个 适配器 ,与 Spinner 这 个 图 形 显示 控件 联系 起 
来 ,使 数组 数据 直接 按照 列表 的 形式 显示 ,不 必 再 做 布局 的 设计 。 这 个 功能 就 是 填充 布局 
的 作用 。 


© Selecta planet 


Q 


Earth 


图 8.3 Spinner 显示 结果 


如 果 布 局 是 动态 的 或 者 非 预定 义 的 ,可 以 在 运行 时 使 用 一 个 布局 子 类 AdapterView 
来 填充 布局 。AdapterView 类 的 子 类 使 用 一 个 适配器 将 数据 绑 定 到 它 的 布局 。 适 配器 把 
数据 源 和 AdapterVievw 布局 连接 起 来 ,适配器 检索 数据 ,例如 把 数据 从 数组 或 者 数据 库 
提取 出 来 ,将 其 转换 成 可 以 添加 到 AdapterView 布局 视图 中 的 条 目 。 
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通用 的 适配器 布局 包括 ListView( 见 图 8. 4(a)) 和 GridView( 见 图 8. 4(b) ) 。 


(a) (b) 


图 8.4 ListView 和 GridView 适配器 布局 界面 
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ListView 是 AdapterView 的 子 类 ,用 于 列表 显示 。ListView 的 定义 有 两 种 方式 : 

。 继承 ListActivity 类 ,使 用 其 内 置 的 ListView 对 象 。 

。 在 布局 文件 中 定义 自 定义 视图 的 ListView。 

ListActivity 是 一 个 专门 显示 ListView 的 Activity 类 , 它 内 置 了 ListView 对 象 ,只 
要 设置 了 数据 源 , 就 会 自动 地 显示 出 来 。 虽 然 ListActivity 内 置 了 ListView 对 象 ,但 依然 
可 以 在 布局 文件 中 自 定义 视图 。 

自 定义 视图 时 ,在 布局 文件 中 要 注意 设置 ListView 对 象 的 id 为 @id/android:list; 而 
在 Java 代码 里 使 用 android. R. id. list 来 引用 ListView 视图 。 在 使 用 ListActivity 来 显 
示 ListView 视图 时 ,如 果 使 用 了 自 定 的 布局 文件 ,通过 setContentView() 方 法 进行 绑 定 ， 
如 果 不 使 用 自 定义 的 布局 文件 ,这 个 步骤 可 以 省 略 。 

Android 系统 为 我 们 提供 了 多 种 模板 进行 选择 ,例如 : 
Simple_list_item_1 表示 每 行 有 一 个 TextView。 
Simple_list_item_2 表示 每 行 有 两 个 TextView。 
Simple_list_item_checked 表示 每 行 带 CheckView 的 项 。 
Simple_list_item_multiple_choise 表示 每 行 有 一 个 TextView 并 可 以 多 选 。 
Simple_list_item_single_choice 表示 每 行 有 一 个 TextView, 但 只 能 进行 单 选 。 

如 果 以 上 模板 还 无 法 满足 我 们 的 要 求 , 那 只 能 自 定义 模板 。 

自 定义 模板 可 以 根据 自己 的 需要 定义 成 任意 的 格式 ,包括 图 片 .方案 及 其 他 可 显示 的 
视图 ,而 且 还 要 考虑 怎样 进行 视图 的 数据 绑 定 。 

ListView 是 一 个 经 常用 到 的 控件 ,ListView 里 面 的 每 个 子 项 Ttem 可 以 是 一 个 字符 
串 ,也 可 以 是 一 个 组 合 控件 。ListView 要 正常 显示 需要 三 个 元 素 : 

。 用 来 显示 数据 的 ListView 控件 。 

。 用 来 显示 的 数据 。 

。 用 来 将 数据 和 ListView 绑 定 的 ListAdapter。 

对 ListView 进行 数据 绑 定 ,必须 选择 使 用 适配器 。 其 中 最 经 常 与 ListView 进行 配 
合 使 用 的 有 ArrayAdapter、CursorAdapter 及 SimpleAdapter 等 。 


ns 二 


下 面 这 个 例子 ,说 明了 如 何 使 用 ListView 显示 8. 3. 2 节 所 创建 的 ContentProvider 
的 内 容 。 
代码 8.17 StudentsContract. java 


oe/ 基于 Android 平 台 的 移动 互联 网 开发 


代码 8.18 MainActivity. java 


8.5 小 结 


本 章 主要 介绍 了 Android 的 4 大 基础 组 件 之 一 ContentProvider 组 件 。Content- 
Provider 是 Android 系统 提供 给 用 户 的 一 个 接口 ,用 于 管理 如 何 访问 应 用 程序 私有 数据 
的 存储 库 。 这 里 的 数据 包括 结构 化 存储 数据 和 非 结 构 化 存储 数据 。 

应 用 程序 使 用 ContentResolver 类 客户 端 对 象 来 访问 ContentProvider 的 数据 ,可 以 
称 其 为 访问 提供 器 。ContentResolver 的 方法 提供 了 基本 的 CRUD( 创 建 、 检 索 、 更 新 和 删 
除 ) 数 据 存 储 的 功能 。 

应 用 程序 通过 ContentResolver 的 对 象 访问 provider 时 ,所 使 用 的 方法 会 调用 
ContentProvider 一 个 具体 子 类 同名 的 方法 。ContentProvider 对 象 通过 URI 来 选择 要 访 
问 provider 的 表 和 数据 ,Content URI 就 是 ContentProvider 中 数据 的 内 容 统一 资源 标 
识 , 能 够 在 存储 介质 中 唯一 标识 ContentProvider 中 数据 所 在 的 具体 位 置 。 

当 我 们 想 用 合适 的 方式 显示 并 操作 一 些 数据 (如 数组 .链表 、 数 据 库 等 ) 的 时 候 , 可 以 
使 用 AdapterView 来 显示 交互 界面 ,这 种 方式 称 为 数据 绑 定 。ContentProvider 所 提供 的 
数据 可 以 使 用 数据 绑 定 的 方式 来 显示 。 
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触摸 事件 处 理 


和 触摸屏 是 智能 手机 和 平板 电脑 最 重要 的 输入 输出 工具 ,用 户 在 与 系统 或 应 用 程序 交 
互 过 程 中 ,大 多 数 操作 都 是 通过 触摸 屏 来 完成 的 。 触 摸 屏 由 特殊 材料 制 成 ,可 以 获取 屏幕 
上 的 压力 ,并 转换 成 屏幕 坐标 。 这 些 信息 可 以 被 转换 成 数据 ,并 被 传递 到 软件 里 。 所 以 ， 
应 用 程序 需要 经 常 处 理 用 户 的 触摸 输入 ,包括 一 个 手指 的 触摸 和 多 个 手指 的 触摸。 


9.1 理解 触摸 事件 


触摸 屏 可 以 感知 手指 的 触摸 压力 ,识别 手指 是 抬 起 、 按 下 或 者 是 移动 ;而 且 可 以 将 触 
点 转换 成 屏幕 坐标 ,通过 计算 屏幕 坐标 的 变化 ,可 以 识别 触 点 的 移动 方式 。 当 用 户 触摸 屏 
幕 时 ,触摸 事件 就 会 产生 。 

1. 什么 是 手势 

手势 是 指 系统 可 识别 的 ,用 户 在 对 屏幕 显示 对 象 操作 时 ,手指 在 触摸 屏 上 抬 起 、 按 下 
或 移动 的 方式 。 在 Android 系统 中 支持 的 核心 手势 包括 以 下 几 种 。 

。 触摸 CTouch) : 按 下 , 抬 起 。 触 发 项 目的 默认 操作 。 

。 长 按 (Long Press) : 按 下 ,等 待 , 抬 起 。 进 入 选择 模式 。 使 用 户 可 以 选择 视图 中 的 
单个 或 者 多 个 项 目 , 并 选择 上 下 文 操作 栏 的 功能 。 
滑动 (Swipe) : 按 下 ,移动 , 抬 起 。 滚 动 内 容 或 者 在 同一 层级 的 不 同 视图 间 切 换 。 
。 拖 电 (Drag): 长 按 ,移动 , 抬 起 。 重 新 排列 视图 中 的 数据 或 者 将 数据 移动 到 容器 
(例如 主屏 幕 上 的 目录 ) 中 。 
双击 (Double Touch) : 快速 两 次 触摸 ,放大 内 容 。 在 文字 选择 中 作为 辅助 手势 。 
放大 (Pinch Open) : 用 两 个 手指 按 住 ,向 相互 远离 的 方向 移动 , 抬 起 ,放大 内 容 。 

。 缩小 (Pinch Close) : 用 两 个 手指 按 住 ,向 相互 接近 的 方向 移动 , 抬 起 ,缩小 内 容 。 

2. 触摸 事件 

在 Android 系统 中 ,触摸 事件 由 MotionEvent 类 来 描述 。 产 生 一 个 触摸 事件 ,系统 就 
会 创建 一 个 MotionEvent 对 象 , 该 对 象 包含 了 触摸 事件 发 生 的 时 间 和 位 置 ,以 及 发 生 触 
摸 事 件 所 在 区 域 的 压力 、 大 小 和 方向 。 在 应 用 中 ,MotionEvent 对 象 会 被 传递 到 某 些 方法 
中 ,其 中 包括 View 类 的 onTouchEvent() 方 法 。 因 为 View 类 是 很 多 控件 的 父 类 ,这 就 意 
味 着 很 多 控件 都 可 以 通过 MotionEvent 与 用 户 进行 交换 。 例 如 ,MapView 控件 可 以 接受 
触摸 事件 ,允许 用 户 平移 动 地 图 到 感 兴趣 的 地 方 ; 或 者 虚拟 键盘 对 象 接收 触摸 事件 激活 虚 
拟 键 ,实现 在 界面 中 输入 文本 。 


图 9.1 手势 定义 


从 用 户 手 指 触摸 设备 屏幕 开始 ,到 手指 离开 设备 屏幕 结束 ,Android 系统 会 产生 一 系 
列 与 手指 运动 相关 触摸 事件 ,每 个 触摸 事件 都 记录 手指 运动 的 信息 , 称 这 些 触 摸 事件 为 一 
个 事件 序列 。 实 际 上 ,很 多 触摸 屏 设备 可 以 同时 记录 多 个 手指 的 运动 轨迹 ,这 样 每 个 运动 
轨迹 都 会 产生 一 个 触摸 事件 序列 。 每 个 序列 是 从 用 户 触摸 屏幕 开始 , 当 用 户 在 屏幕 上 移 
动 时 ,这 个 序列 会 持续 添加 ; 当 手 指 从 屏幕 上 抬 起 后 ,这 个 序列 也 就 结束 。 

MotionEvent 类 中 定义 了 动作 常量 表示 和 触摸 事件 的 动作 类 型 ,主要 包括 ACTION_ 
DOWN、ACTION_UP、ACTION_CANCEL、ACTION_MOVE 等 。 当 用 户 首次 触摸 屏 
幕 时 ,系统 会 将 带 有 ACTION_DOWN 的 触摸 事件 传递 给 相应 的 视图 控件 ; 当 手 指 在 屏 
幕 上 移动 是 ACTION_MOVE; 当 抬 起 手指 是 ACTION_UP:; 而 且 在 手指 抬 起 之 前 系统 可 
能 会 产生 很 多 ACTION _MOVE 的 触摸 事件 。 所 有 这 些 触摸 事件 都 会 产生 相应 的 
MotionEvent 对 象 ,其 中 包含 了 动作 的 种 类 、 触 摸 发 生 的 位 置 . 触 摸 的 压力 .触摸 的 面积 、 
动作 发 生 的 时 间 和 初始 ACTION_DOWN 的 时 间 等 属性 。 而 ACTION_OUTSIDE 是 一 
个 特殊 动作 ,是 指 当 手 指 移 动 到 在 窗 体 之 外 时 ,系统 仍然 可 以 得 到 这 样 的 触 控 事 件 。 一 般 
来 说 ,一 个 手指 触摸 屏幕 会 触发 了 一 个 最 简单 的 触摸 事件 序列 首先 应 该 是 ACTION_ 
DOWN, 然 后 会 有 多 个 ACTION_MOVE, 最 后 是 一 个 ACTION_UP 结束 。 

有 些 触摸 屏 设备 可 以 在 同一 时 间 发 现 多 个 移动 轨迹 , 称 为 多 点 触 控 。Android 系统 
的 MotionEvent 类 也 支持 多 点 触 控 。 其 中 包括 ACTION _POINTER _DOWN 和 
ACTION_POINTER_UP 两 个 动作 常量 ,分 别 表示 除 第 一 个 之 外 的 手指 在 屏幕 触摸 时 的 
动作 ,和 除 第 一 个 之 外 的 手指 从 屏幕 抬 起 时 的 动作 。 
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MotionEvent 类 使 用 两 个 属性 来 表示 具体 的 触 点 ,一 个 是 触 点 ID, 另 一 个 是 触 点 索 
引 , 并 提供 许多 方法 用 来 查询 每 个 触 点 位 置 以 及 其 他 属性 ,如 getX (int)、getY (int)、 
getAxisValue(int) ,getPointerld(int) ,getToolType(int) 等 。 这 些 方法 中 大 部 分 接收 触 
点 索引 作为 参数 而 不 是 触 点 ID。getPointerCount() 方 法 可 以 获得 指针 总 数量 ,而 触 点 索 
引 的 取 值 范围 是 从 0 开始 ,到 指针 总 数量 减 1 结束 。 当 发 生 多 点 触摸 事件 时 ,每 个 触 点 索 
引 是 会 发 生变 化 的 ,而 触 点 ID 在 触摸 点 移动 过 程 中 不 会 发 生变 化 。getPointerId(int) 方 
法 传人 和 触 点 索引 可 以 获得 触 点 ID ,而 findPointerIndex(int) 方 法 传人 触 点 ID 可 以 获得 触 
点 索引 。 

当 多 点 触 控 事 件 发 生 时 ,系统 可 能 产生 的 事件 见 表 9-1。 


表 9-1 触 控 事件 
触摸 事件 描 述 
MotionEvent. ACTION_DOWN 新 的 触摸 事件 
MotionEvent. ACTION_MOVE 移动 手指 
MotionEvent. ACTION_UP 手指 抬 起 
MotionEvent. ACTION_CANCEL 删除 事件 
MotionEvent. ACTION_POINTER_DOWN 多 点 按 下 
MotionEvent. ACTION_POINTER_UP 多 点 抬 起 


由 于 应 用 程序 的 开发 ,在 真 机 调试 之 前 ,都 是 在 模拟 机 上 调试 的 ,在 处 理 多 点 触 控 事 
件 时 ,需要 注意 模拟 机 和 真 机 上 触 屏 事 件 有 一 些 不 同 。 

(1) 屏幕 的 精度 : 在 模拟 机 上 的 精度 是 整数 ,例如 52 x 20; 而 在 真 机 上 是 有 小 数 , 例 
如 42. 8374 X 25. 293747。MotionEvent 的 位 置 由 X 轴 和 YY 轴 坐 标 组 成 的 ,X 轴 表 示 从 视 
图 左手 边 到 触 屏 点 的 距离 ,Y 轴 表 示 从 视图 的 顶端 到 触 屏 点 的 距离 。 

(2) 触摸 事件 中 压力 描述 : 在 模拟 机 上 的 压力 值 为 0, 而 在 真 机 上 输出 的 压力 值 表示 
手指 在 触摸 屏 上 向 下 的 力度 。 如 果 使 用 小 拇指 的 指 尖 轻 轻 触 摸 , 则 触摸 事件 的 压力 和 大 
小 比较 小 ;如 果 用 力 使 用 大 拇指 , 则 触摸 事件 的 压力 和 大 小 都 是 比较 大 的 。 触 摸 事件 的 压 
力 和 大 小 是 在 0 和 1 之 间 。 但 是 ,对 于 不 同 的 设备 来 说 ,没有 一 个 绝对 的 值 用 来 比较 触摸 
事件 的 压力 和 尺寸 的 大 小 ;而 对 于 同一 个 设备 来 说 ,只 能 相对 地 比较 触摸 事件 之 间 的 压力 
和 尺寸 大 小 ,不 能 拿 一 个 绝对 的 值 来 确定 压力 和 尺寸 的 大 小 。 例 如 ,在 某 些 设备 上 这 个 值 
从 来 不 超过 0. 8 ,而 某 些 设备 上 这 个 值 从 来 不 超过 0. 2。 

(3) 触摸 事件 序列 : 在 Android 中 使 用 触摸 屏 时 ,如 果 应 用 程序 在 模拟 器 中 运行 , 当 
鼠标 当 单 击 一 次 模拟 器 屏 然 后 释放 后 ,会 先 触 发 ACTION_DOWN 然后 是 ACTION_UP 
这 两 个 触摸 事件 ,只 有 在 屏幕 上 移动 时 才 会 触发 ACTION_MOVE 的 动作 ;但 在 真 机 中 
测试 时 , 单 击 会 首先 产生 ACTION_DOWN 和 触摸 事件 ,如 果 手 指 不 抬 起 的 话 即 使 不 移动 
也 会 一 直 产 生 ACTION_MOVE 触摸 事件 ,手指 只 有 离开 屏幕 时 才 会 产生 ACTION_UP 
触摸 事件 。 

当 手 指 触摸 到 设备 的 边界 位 置 时 ,触摸 事件 的 边界 标记 会 被 检测 到 。 而 Android 文 
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档 上 说 , 当 触 摸 到 设备 的 边界 时 ( 顶 、 底 、 左 和 右 ) 时 ,这 个 标记 会 被 设置 。 但 是 有 时 
getEdgeFlags() 方 法 总 是 显示 为 0。 实际 上 ,有 些 硬件 是 很 难 检测 到 触摸 在 设备 的 边界 
上 ,所 以 Android 系统 不 可 能 设置 这 个 参数 。MotionEvent 类 提供 了 setEdgeFlags() 方 
法 ,目的 是 可 以 自己 来 设置 这 个 值 。 


9.2 事件 传递 机 制 


当 触 摸 事 件 发 生 时 ,MotionEvent 对 象 会 作为 参数 被 传递 到 应 用 程序 的 相应 方法 中 。 
在 Android 系统 中 ,ViewGroup、View、Activity 以 及 它们 的 子 类 都 提供 了 处 理 触摸 事件 
的 回调 方法 。 触 摸 事件 与 前 面 所 接触 的 按钮 .编辑 框 \ 菜 单 和 动作 条 等 图 形 控件 的 事件 有 
所 不 同 。 当 用 户 直接 针对 这 些 图 形 控件 的 进行 键盘 操作 时 ,应 用 程序 直接 回调 对 应 的 注 
册 监 听 器 进行 处 理 。 但 当 触摸 事件 发 生 时 ,会 遇 到 多 种 情况 。 例 如 屏幕 中 包含 一 个 
ViewGroup ,而 这 个 ViewGroup 又 包含 一 个 子 View 时 ,Android 系统 如 何 处 理 触摸 事件 
呢 ? 到底 是 ViewGroup 来 处 理 触摸 事件 ,还 是 子 View 来 处 理 触摸 事件 呢 ? 如 果 一 个 视 
图 控件 注册 了 OnClickListener 和 OnLongClickListener 监听 器 ,分别 实 现 了 onClick() 和 
onLongClick() 方 法 , 当 用 户 触摸 到 屏幕 上 的 这 个 视图 控件 时 ,Android 系统 如 何 区 分 应 
当 使 用 onTouchEvent() 方 法 ,还 是 onClick() 方 法 ,或 是 onLongClick() 方 法 来 处 理事 
件 呢 ? 

如 果 要 解答 这 些 问题 ,需要 深入 理解 触摸 事件 的 传递 和 消费 机 制 。 在 Android 系统 
中 ,同一 个 触摸 事件 可 以 按 次 序 传递 到 不 同 视图 控件 ,所 以 可 以 依次 被 视图 控件 处 理 , 如 
果 某 视图 控件 完全 响应 而 且 不 再 传递 这 个 触摸 事件 , 则 称 为 消费 了 触摸 事件 。 

真正 理解 了 触摸 事件 的 传递 和 消费 机 制 ,才能 编写 出 正确 响应 界面 操作 的 代码 ,尤其 
当 屏 幕 上 的 不 同 视图 控件 ,需要 针对 同一 个 界面 触摸 事件 做 出 不 同 响应 的 时 候 。 例 如 ,应 
用 程序 在 桌面 上 设置 了 一 个 控件 , 当 用 户 针对 控件 做 各 种 操作 时 ,桌面 本 身 有 的 时 候 要 对 
用 户 的 操作 做 出 响应 ,有 时 忽略 。 只 有 搞 清楚 事件 触发 和 传递 的 机 制 才 有 可 能 保证 在 界 
面 布局 非常 复杂 的 情况 下 ,UI 控件 仍然 能 正确 响应 用 户 操 作 。 

在 触摸 事件 处 理 时 ,一 个 用 户 的 操作 可 能 会 被 传递 到 不 同 的 控件 ,或 同一 个 控件 的 不 
同 监听 方法 内 进行 处 理 。 如 果 任 何 一 个 接收 该 事件 的 方法 在 处 理 完 后 返回 了 true, 则 该 
事件 就 算 处 理 完成 了 ,其 他 的 视图 或 者 监听 方法 就 不 会 再 有 机 会 处 理 该 事件 。 
921 内 外 层次 之 间 

一 般 来 说 ,用 户 界 面 的 树 形 结构 是 由 多 个 View 和 ViewGroup 形成 的 ,它们 之 间 具 
有 由 外 向 内 的 包含 关系 ,而 触摸 事件 可 以 在 相 邻 的 层次 之 间 传 递 ,传递 方向 先 从 外 向 内 ， 
然后 从 内 向 外 。 从 外 向 内 传递 就 是 从 最 外 层 的 根 元 素 依次 递归 向 其 包含 的 子 元 素 传递 ， 
一 直到 最 内 层 子 元 素 ,或 中 间 某 个 元 素 消 费 了 触摸 事件 ,结束 了 传递 ;从 内 向 外 就 是 从 最 
内 层 子 元 素 依 次 递归 向 外 层 传递 ,直到 根 元 素 或 中 间 某 个 元 素 消费 了 触摸 事件 ,结束 了 
传递 。 

Android 系统 使 用 下 面 3 个 方法 来 处 理 触摸 事件 的 传递 。 
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(1) public boolean dispatchTouchEvent (MotionEvent ev): 这 个 方法 是 View、 
Activity 和 ViewGroup 类 中 的 方法 ,用 来 分 发 触摸 事件 。 可 以 把 这 个 方法 作为 一 个 控制 
器 ,由 其 决定 如 何 路 由 触摸 事件 。View 类 中 的 dispatchTouchEvent() 方 法 判断 是 将 触摸 
事件 传递 给 View. OnTouchListener. onTouchEvent() 或 者 View. onTouchEvent() 方 法 。 
ViewGroup 类 中 的 dispatchTouchEvent() 方 法 覆盖 了 View. dispatchTouchEvent( ) 方 
法 ,其 包含 了 更 复杂 的 算法 用 来 弄 清楚 哪个 子 视图 应 该 得 到 触摸 事件 ,而 且 需 要 调用 子 视 
图 的 dispatchTouchEvent() 方 法 。 

(2) public boolean onInterceptTouchEvent (MotionEvent ev): 这 个 方法 只 
ViewGroup 类 中 的 方法 ,用 来 拦截 触摸 事件 。ViewGroup 一 般 都 会 包含 View, 而 
ViewGroup 和 View 都 包含 onTouchEvent() 方 法 ,如 果 onInterceptTouchEvent() 返 回 
true 时 , 则 执行 此 ViewGroup 中 的 onTouchEvent () 方 法 ;如 果 onInterceptTouchEvent () 
返回 false 时 ,触摸 事件 将 传递 给 View ,由 View 的 dispatchTouchEvent() 再 来 开始 这 个 
事件 的 分 发 。 

(3) public boolean onTouchEvent(MotionEvent ev) : 这 个 方法 可 以 用 来 处 理 触摸 
事件 。 该 方法 在 View、ViewGroup 以 及 Activity 类 中 都 有 定义 ,并 且 所 有 的 View 子 类 
全 部 重 写 了 该 方法 ,包括 Layouts、Buttons、Lists、Surfaces、Clocks 等 ,这 说 明 所 有 的 这 些 
组 件 都 可 以 使 用 触摸 事件 进行 交互 ,应 用 程序 可 以 通过 该 方法 处 理 手 机 屏幕 的 触摸 事件 。 

下 面 一 个 例子 可 以 测试 这 种 触摸 事件 的 传递 方式 。 在 一 个 自 定义 的 布局 中 包含 自 定 

义 的 TextView 控件 ,并 且 分 别 覆 盖 Activity、 自 定义 布局 和 TextView 中 的 三 个 方法 , 方 
法 的 内 容 主 要 是 日 志 输出 和 控制 触摸 事件 的 传递 。 

首先 ,创建 一 个 LinearLayout 的 子 类 ,覆盖 上 面 所 列 出 的 处 理 触 摸 事 件 的 三 个 方法 
dispatchTouchEvent() .onInterceptTouchEvent() 和 onTouchEvent() ,处 理 在 这 个 布局 
上 发 生 的 触摸 事件 。 当 在 不 同 的 触摸 事件 发 生 时 ,根据 事件 的 类 型 ,输出 带 有 事件 处 理 方 
法 和 事件 类 型 的 日 志 信 息 ( 见 代 码 9. 1) 。 

代码 9.1 自 定义 布局 

Public class MyiayoutView extends LinearTayout { 
private final String TRG= "MyLayoutView"; 
Public MyTayoutView (Context omtext, AttributeSet attrs) { 


Super (oontext, attrs); 
Iog.d(IG, TS); 
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定义 一 个 TextView 类 的 子 类 作为 用 户 界面 布局 中 的 输入 框 , 并 覆盖 其 触摸 事件 处 
理 的 方法 dispatchTouchEvent() 和 onTouchEvent, 实 现 当 在 不 同 的 触摸 事件 发 生 时 , 根 
据 事件 的 类 型 ,输出 带 有 事件 处 理 方法 和 事件 类 型 的 日 志 信息 。 

代码 9.2 自 定义 输入 框 
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然后 ,定义 用 于 测试 的 Activity 的 布局 文件 ,其 中 定义 触摸 事件 传递 的 层次 关系 ( 见 
代码 9. 3。 
代码 9.3 XML 布局 文件 
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android:layout width= "200dip" 
android: layout. height= "100dip" 
android:background= " 啡 00FF00" 
android:text= "My TextView" 
android:textColor= 啡 0000FF" 
android:textSize= "20sp" 
android:textStyle= "bold"/> 


< /cn.edu.uibe. 


.Chapterl] .motionEvent .motionEvent .MyLayoutView> 


定义 好 布局 文件 后 ,创建 一 个 Activity, 导 入 所 定义 的 XML 布局 文件 ,运行 应 用 程 
序 , 可 以 显示 出 图 9. 2 所 示 的 界面 。 

在 图 9.2 显示 的 界面 中 ,从 外 到 内 包括 一 个 Activity 
(View) ,一 个 自 定义 Layout(ViewGroup) 和 一 个 自 定义 的 
TextView(View)。 深 灰 部 分 是 自 定义 布局 , 浅 灰 部 分 是 自 
定义 的 TextView。 如 果 用 手指 触摸 界面 ,就 会 产生 一 系列 
触摸 事件 。 首 先 产生 的 是 MotionEvent. ACTION_DOWN 
事件 ,这 是 触摸 事件 系列 的 第 一 个 事件 。 人 

在 触摸 事件 传递 过 程 中 ,ACTION_DOWN 经 过 的 界面 元 素 实际 上 都 是 继承 了 View 
或 者 ViewGroup 类 ,这 两 个 类 中 都 包含 dispatchTouchEvent( ) 方 法 ,但 是 触摸 事件 处 理 
的 最 外 层 却 不 是 这 些 界面 元 素 , 而 会 首先 调用 当前 Activity 的 dispatchTouchEvent() 方 
法 ,然后 才 将 触摸 事件 传递 给 其 中 的 View 或 者 ViewGroup 元 素 。 这 样 ,触摸 事件 首先 
最 外 层 View 或 者 ViewGroup 元 素 向 内 层 View 或 者 ViewGroup 元 素 传递 。 

在 触摸 事件 从 外 层 的 界面 元 素 向 内 层 界面 元 素 传 递 过 程 中 ,如 果 事件 传递 到 继承 了 
ViewGroup 类 的 界面 元 素 , 则 会 调用 ViewGroup 类 的 onInterceptTouchEvent() 方 法 ,这 
个 方法 表示 是 否 拦截 触摸 事件 。 如 果 这 个 方法 返回 true, 表 示 这 个 ViewGroup 拦截 了 事 
件 的 传递 ,触摸 事件 不 会 再 往 下 传递 给 它 的 子 View 元 素 , 而 是 由 这 个 ViewGroup 元 素 
处 理 , 调 用 其 onTouchEvent() 方 法 ;如 果 在 传递 的 过 程 中 没有 ViewGroup 拦截 事件 , 即 
经 过 的 所 有 onInterceptTouchEvent() 方 法 都 返回 false, 那 么 触摸 事件 最 终 会 传递 至 最 内 
层 的 界面 元 素 ,一 般 是 一 个 视图 控件 ,当然 也 可 以 是 一 个 ViewGroup 元 素 ( 其 内 部 不 包含 
任何 元 素 ) 。 

如 果 最 后 事件 传递 到 一 个 View 元 素 , 而 非 ViewGroup 元 素 ,那么 会 首先 调用 这 个 
View 的 OnTouchListener() 的 onTouch() 方 法 或 者 调用 View 的 onTouchEvent() 方 法 ， 
其 默认 返回 true; 如 果 最 后 事件 传递 到 一 个 ViewGroup 元 素 , 会 调用 它 的 onTouchEvent () 
方法 ,其 默认 返回 false, 这 样 就 完成 了 触摸 事件 从 外 向 里 的 传递 。 

在 上 面 示例 中 的 Activity 和 自 定义 布局 的 三 种 方法 方法 的 返回 值 都 为 false, 则 触摸 
事件 传递 到 最 内 层 的 自 定义 TextView。 由 于 自 定义 的 TextView 的 onTouchEvent() 返 
回 值 为 true, 所 以 触摸 事件 被 消费 。 图 9. 3 示意 了 从 外 向 内 传递 触摸 事件 的 路 径 。 
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dispatchTouchEvent() 


onTouchEvent() 


dispatchTouchEvent() 


onInterTouchEvent() 
onTouchEvent() 


dispatchTouchEvent() 


onTouchEvent() 


图 9.3 触摸 事件 从 外 向 内 传递 


下 面 是 这 个 过 程 的 日 志 输 出 : 


07- 16 21:43:07.809: D/InterosptTouchActivity (18468) : dispatchTouchEvent action:RCTION_DORN 
07- 16 21:43:07.814: D/MyLayoutView (18468) : dispatchTouchEvent acticn:RCTION_DORN 

07- 16 21:43:07.814: D/MyLayoutView (18468) : onInteroeptTouchEvent. action:ACTICN DORN 

07- 16 21:43:07.814: D/MTextView (18468) : dispat duchEvent. acticn:ACTION DONN 

07- 16 21:43:07.814: D/MyTextView (18468) : onTouchEvent acticn:RCTION_DORN 

07- 16 21:43:07.834: D/InterceptTouchactivity(18468) : dispatchTouchEvent action:ACTION MOVE 
07- 16 21:43:07.834: D/MyLayoutView (18468) : dispatchTouchEvent action:ACTION MNE 

07- 16 21:43:07.834: D/MyLayoutView (18468) : anInterceptTouchEvent action:ACTION MNE 

07- 16 21:43:07.834: D/MTextView (18468) : 由 spbatchIbuchEvent acticn:ACTION MNE 

07- 16 21:43:07.834: D/MyTextView (18468) : onTouchEvent. action:ACTION MDNE 

07- 16 21:43:07.834: D/InterceptTouchactivity(18468) : dispatchTouchEvent action:ACTION UP 
07- 16 21:43:07.834: D/MyLayoutView (18468) : dispatchTouchEvent action:ACTION UP 

07- 16 21:43:07.834: D/MyLayoutView (18468) : anInterceptTouchEvent action:ACTION UP 


O07- 16 21:43:07.834: D/MyTextView (18468) : dispatchIbuchPvent acticn:ACTION UP 
07- 16 21:43:07.834: D/MyTextView (18468) : onTouchEvent action:ACTION UP 


如 果 上 面 例子 中 自 定义 TextView 的 onTouchEvent() 方 法 返回 了 false, 则 接 下 来 的 
触摸 事件 , 即 ACTION_DOWN 的 此 事件 系列 的 后 续 触摸 事件 ,就 不 会 再 传递 到 View 或 
者 ViewGroup 元 素 ,而 会 在 其 父 元 素 终止 ,并 且 调 用 其 父 元 素 的 onTouchEvent()。 

这 就 是 说 ,如 果 最 内 层 界 面 元 素 的 onTouchEvent() 方 法 返回 了 false, 则 事件 会 自 内 
向 外 再 次 传递 ,直到 某 个 界面 元 素 onTouchEvent() 方 法 返回 true。 这 时 ,此 事件 系列 的 
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后 续 触摸 事件 ,也 会 直接 由 这 个 界面 元 素 的 onTouchEvent() 方 法 来 处 理 。 

如 果 自 内 向 外 的 所 有 View 或 者 ViewGroup 界面 元 素 的 onTouchEvent() 方 法 都 返 
回 false, 那 么 ACTION_DOWN 的 此 事件 系列 的 后 续 触摸 事件 ,最 后 会 由 Activity 处 理 ， 
即 调 用 Activity 的 onTouchEvent() 方 法 ,并 且 最 终结 束 触摸 事件 的 传递 ,这 就 是 从 内 向 
外 的 触摸 事件 的 传递 。 

还 是 使 用 上 面 的 例子 ,只 是 在 代码 9.2 中 ,将 自 定义 TextView 的 onTouchEvent() 
方法 返回 值 改 为 false, 触 摸 事 件 就 从 内 向 外 传递 触摸 事件 ( 见 图 9. 4 虚线 所 示 )。 


dispatchTouchEvent() 


‘onTouchEvent() 


dispatchTouchEvent() dispatchTouchEvent() 


onInterTouchEvent() 
onTouchEvent() 


onTouchEvent() 


图 9.4 触摸 事件 从 内 向 外 传递 


下 面 是 这 个 过 程 的 日 志 输 出 : 


07- 16 22:17:55.110: D/InterosptTouchActivity (19689) : dispatchTouchEvent action:ACTION DOWN 
07- 16 22:17:55.114: D/MyLayoutView (19689) : dispatchTouchEvent action:ACTION DORN 


07- 16 22:17:55.114: D/MyLayoutView (19689) : anInterceptTouchEvent action:ACTION DOWN 

07- 16 22:17:55.114: DAMYIEzxtView (19689) : dispatchHTbuchEvent acticn:PRCTICN DONN 

07- 16 22:17:55.114: D/MyTextView (19689) : onTouchEvent acticn:RCTICN DORN 

07- 16 22:17:55.114: D/MyLayoutView (19689) : onTouchEvent action:ACTION DONN 

07- 16 22:17:55.114: D/InterosptTouchActivity (19689) : onTouchEvent action:RCTION DONN 

07- 16 22:17:55.114: D/InterosptTouchActivity (19689) : dispatchTouchEvent action:ACTION UP 
07- 16 22:17:55.114: D/InterceptTouchactivity(19689) : onTouchEvent action:ACTION UP 


如 上 面 的 示例 一 样 ,如 果 改 变 三 种 方法 的 返回 值 .会 有 不 同 的 日 志 输 出 ,可 以 尝试 改 
变 其 他 方法 的 返回 值 , 体 会 一 下 触摸 事件 传递 的 原理 。 
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922 同一 层次 之 间 
另 一 种 响应 触摸 事件 的 方式 ,就 是 设置 OnTouchListener 监听 器 。OnTouchListener 


是 用 来 处 理 屏幕 触摸 事件 的 监听 接口 , 当 在 View 的 范围 内 触摸 按 下 、 抬 起 或 滑动 等 动作 
时 都 会 触发 该 事件 。 需 要 实现 该 接口 的 方法 为 : 


Public boolean cnTouch (View v, MotionEvent event) 


其 中 ,参数 v 为 事件 源 对 象 ;而 参数 event 为 手机 屏幕 触摸 事件 封装 类 的 对 象 ,其 中 
封装 了 该 事件 的 所 有 信息 ,例如 触摸 的 位 置 、. 触 摸 的 类 型 以 及 触摸 的 时 间 等 。 该 对 象 会 在 
用 户 触摸 手机 屏幕 时 被 创建 。 当 这 个 方法 的 返回 值 为 true 时 ,表示 处 理 完 触摸 事件 且 不 
传递 到 其 他 回调 方法 ,和 否则 返回 false。 

现在 ,应 该 回想 一 下 第 4 章 的 内 容 。 可 能 有 人 会 问 , 如 果 用 户 单 击 界面 就 会 产生 触摸 
事件 吗 ? 如 果 同 时 为 一 个 控件 注册 了 OnClickListener、OnLongClickListener 和 
OnTouchListener, 而 且 还 覆盖 了 onTouchEvent() 方 法 ,触摸 事件 的 传递 顺序 又 是 怎 
样 的 ? 

实际 上 , 当 用 户 完成 一 次 单 击 操作 时 ,屏幕 上 的 触摸 传感器 得 到 的 按 下 和 抬 起 信号 ， 
可 以 理解 为 发 生 了 触摸 事件 的 ACTION _DOWN 和 ACTION_UP 操作 。 所 以 ,在 
Android 中 的 单 击 事件 是 和 触摸 事件 相关 的 。 如 果 在 一 个 View 中 覆盖 了 onClick()、 
onLongClick() 及 onTouchEvent() 方 法 , 则 onTouchEvent() 最 先 捕 提 到 ACTION _ 
DOWN 事件 的 ,其 次 才 可 能 触发 onClick() 方 法 或 者 onLongClick() 方 法 ,以 及 后 续 的 触 
摸 事件 。 

根据 触摸 事件 处 理 的 逻辑 ,下 面 对 同 时 作用 在 控件 上 的 监听 器 或 onTouchEvent() 方 
法 的 三 种 情况 进行 分 析 。 

(1) OnClickListener、OnLongClickListener 与 onTouchEvent() 同 时 作用 在 一 个 控 
件 上 。 在 实际 操作 中 ,是否 执行 onClick() 和 onLongClick() 方 法 与 触摸 事件 的 ACTION 
_DOWN 和 ACTION_UP 动作 有 关 。 当 一 个 单 击 事件 发 生 时 ,事件 发 生 的 顺序 为 


RCTION DOWN- — > ACTICN UP- ->ocnclick() 


如 果 发 生 了 一 个 长 按 事件 ,就 是 按 下 界面 控件 保持 一 段 时间 , 然 后 抬 起 ,此 时 事件 发 
生 的 顺序 为 : 


ACTICN DONN- — > onLongClick()——>ACTICON UP 


(2) OnTouchListener、onTouchEvent 同时 作用 在 一 个 控件 上 。 首 先 执行 
OnTouchListener. onTouch() 的 方法 ,如 果 返 回 值 为 ture, 则 结束 触摸 事件 的 传递 ;如 果 
返回 值 为 false, 则 继续 传递 触摸 事件 到 onTouchEvent() 方 法 。 

(3) OnClickListener、OnLongClickListener、.OnTouchListener 同时 作用 在 一 个 控件 
上 。 由 于 执行 onLongClick() 方 法 是 由 单独 的 线程 完成 的 ,并 且 在 ACTION_UP 之 前 ,而 
onClick() 的 发 生 是 在 ACTION_UP 后 ,因此 同一 次 用 户 触摸 事件 就 有 可 能 既 发 生 
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onLongClick() 又 发 生 onClick()。 对 于 这 种 情况 ,onLongClick() 方 法 使 用 返回 值 表示 是 
否 消费 了 触摸 事件 。 如 果 在 onLongClick() 方 法 返回 结果 为 true, 那 么 onClick 事件 就 没 
有 机 会 被 触发 。 如 果 onLongClick() 方 法 返回 false 时 的 情况 ,一 次 触摸 事件 的 基本 
时 序 ， 

onTouch (ACTION DOWN)— — > anLongClick()- 一 >cnTouch ACTION UP)- —>OnClick() 

可 以 看 到 ,在 ACTION_UP 后 仍然 触发 了 onClick() 方 法 。 


9.3 速率 跟踪 


在 Android 应 用 程序 开发 过 程 中 ,特别 是 游戏 程序 开发 中 ,可 能 需要 获取 触摸 点 移动 
的 速度 。 也 就 是 当 手 指 在 触摸 屏 上 的 运动 时 ,可 能 希望 知道 其 移动 的 速度 有 多 快 。Android 
提供 了 一 个 VelocityTracker 帮助 类 ,用 来 处 理 触摸 事件 序列 ,跟踪 手指 运动 的 速率 。 

当 需 要 跟踪 速率 的 时 候 , 首 先 使 用 VelocityTracker 的 静态 方法 VelocityTracker 
.obtain() 获得 VelocityTracker 对 象 ,然后 可 以 使 用 VelocityTracker. addMovement 
(MotionEvent event) 方 法 为 添加 触摸 事件 对 象 。 可 以 在 接收 并 且 处 理 MotionEvent 对 
象 的 方法 (例如 OnTouchListener 的 onTouch() 方 法 或 者 onTouchEvent() 方 法 ) 中 添加 
addMovement(MotionEvent event) 。 

下 面 使 用 一 个 简单 的 例子 ,将 触摸 点 移动 的 速度 写 入 日 志 信息 ,在 运行 时 可 以 从 控制 
人 台 看 到 相应 的 信息 。 具 体 实现 见 代码 9. 4, 其 中 touch_velocity_tracker. xml 布局 文件 中 
可 以 只 简单 设置 一 个 TextView。 

代码 9.4 使 用 VelocityTracker 进行 速率 跟踪 


public class VelocityrrackerRctivity extends Activity { 


/x*Called when the activity is first createdx / 
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如 果 VelocityTracker 中 连续 添加 了 两 个 MotionEvent 对 象 ,那么 就 可 以 计算 这 两 个 
MotionEvent 对 象 之 间 的 数据 变化 ,这 些 数据 的 变化 反映 了 手指 的 运动 速率 。 
VelocityTracker 两 个 方法 getXVelocity() 和 getYVelocity() 分 别 返回 手指 在 X 和 也 方 
向 上 的 速率 。 这 两 个 方法 的 返回 值 表示 单位 时 间 段 在 X 和 YY 方向 上 移动 的 像素 。 这 个 
单位 时 间 段 可 以 是 每 毫秒 或 秒 , 也 可 以 是 一 个 设置 的 任意 值 。 

在 使 用 这 两 个 方法 之 前 ,需要 VelocityTracker 类 提供 的 computeCurrentVelocity 
Gint unit) 方 法 ,来 设置 跟踪 速率 时 VelocityTracker 所 使 用 的 时 间 单 位 。 例 如 ,如 果 想 得 
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到 每 毫秒 的 移动 像素 ,给 参数 unit 赋值 为 1; 如 果 想 得 到 每 秒 的 移动 像素 ,给 参数 unit 赋 
值 为 1000。 如 果 手 指 是 朝 着 和 方向 的 右 侧 移动 或 者 Y 方向 的 底部 移动 ,getXVelocity() 
和 getYVelocity() 方 法 的 返回 值 为 正 ; 如 果 手 指 是 朝 着 和 方向 的 左 侧 移动 或 者 Y 方向 的 
顶部 移动 , getXVelocity ( ) 和 getYVelocity ( ) 方法 的 返回 值 为 负 如 果 结 束 
VelocityTracker 对 象 的 使 用 ,需要 使 用 recycle() 方 法 。 

值得 注意 的 是 , 当 第 一 个 ACTION_DOWN 触摸 事件 被 加 入 到 VelocityTracker 时 ， 
速率 计算 的 结果 虽然 是 零 ,但 是 还 是 必须 首先 增加 这 个 起 点 ,这 样 后 续 的 ACTION _ 
MOVE 事件 才 可 以 计算 速率 。 在 ACTION_UP 被 加 入 后 ,速率 的 计算 结果 还 是 会 变 成 
零 。 因 此 ,不 要 在 增加 了 ACTION_UP 触摸 事件 之 后 读 取 X 和 YY 的 速率 。 例 如 , 当 开 发 
一 个 游戏 程序 实现 用 户 在 屏幕 上 扔 物体 时 ,应 该 在 增加 最 后 一 个 ACTION_MOVE 事件 
之 后 ,再 使 用 速率 来 计算 物体 的 轨道 。 

另 一 点 就 是 跟踪 速率 很 耗费 资源 。 所 以 应 该 在 使 用 完 之 后 回收 VelocityTracker 对 
象 ,这 样 此 对 象 还 可 以 重新 被 使 用 。Android 系统 可 以 允许 有 多 个 VelocityTracker 对 象 
同时 存在 ,但 是 同样 会 占用 更 多 的 内 存 。 当 开始 跟踪 一 个 新 的 触摸 序列 时 ,也 可 以 使 用 
clear() 方 法 使 VelocityTracker 对 象 回 到 初始 状态 。 


9.4 多 点 触 控 


在 2006 年 的 TED 大 会 上 ,Jeff Han 展示 了 一 种 具有 多 点 触 控 技术 的 计算 机 屏幕 。 
Android 也 加 入 了 多 点 触 控 功 能 ,目前 市 面 上 只 要 使 用 电容 屏 触 控 原 理 的 手机 均 可 以 支 
持 多 点 触 控 技 术 ,可 以 实现 图 片 和 页 面 缩放 ,手势 操作 等 更 好 的 用 户 体 验 。Android 的 多 
点 触 控 功能 需要 运行 在 Android 2. 0 版 本 以 上 (实际 上 第 一 个 Android 设备 支持 两 个 手 
指 的 多 点 和 触 控 ) 。 对 于 这 个 版 本 ,可 以 在 屏幕 上 同时 使 用 三 个 手指 完成 缩放 、 旋 转 或 者 任 
何 使 用 多 点 触 控 想 做 的 事情 。 

多 点 触 控 和 单 点 触 控 的 基本 原理 是 一 致 的 。 当 手指 触摸 屏幕 时 , MotionEvent 对 象 
被 创建 ,并 且 被 传递 到 前 面 介 绍 的 方法 中 。 还 是 可 以 通过 上 面 介绍 的 MotionEvent 的 
getAction() ,getDownTime() 和 getX() 等 方法 来 获取 触摸 事件 的 数据 。 当 在 屏幕 上 有 多 
个 触 点 时 ,MotionEvent 对 象 必须 包含 所 有 触 点 的 信息 ,但 是 getAction() 方 法 得 到 的 只 
是 一 个 触 点 的 动作 值 , 而 不 是 全 部 的 触 点 。getDownTime() 方 法 表示 第 一 个 手指 按 下 的 
时 间 , 如 果 有 多 个 手指 同时 触摸 屏幕 ,之 后 可 能 有 的 手指 离开 了 屏幕 ,但 是 只 要 屏幕 上 还 
存在 最 后 一 个 触 点 ,这 个 时 间 值 就 一 直 保 持 不 变 。 当 使 用 getXC7 和 getY() 方 法 获取 触摸 
事件 发 生 的 位 置 ,以 及 使 用 getPressure() 方 法 和 getSize() 方 法 获取 触 点 压力 和 大 小 时 ， 
如 果 传人 触 点 索引 参数 ,就 可 以 获得 对 应 触 点 的 信息 。 对 于 不 带 参 数 的 方法 调用 ,只 能 获 
得 第 一 个 触 点 的 信息 。 

如 果 和 希望 使 用 多 点 触 控 , 首 先 要 知道 使 用 getPointerCount() 方 法 获取 当前 屏幕 上 的 
和 触 点 数量 。 只 要 获得 的 触 点 数量 大 于 1 ,就 需要 处 理 触 点 索引 和 和 触 点 ID。MotionEvent 
对 象 中 包含 了 当前 从 索引 为 0 开始 的 触 点 信息 ,一 直到 getPointerCount() 方 法 返回 的 最 
大 索引 值 。 触 点 索引 始终 从 0 开始 ,如 果 有 三 个 触 点 , 则 它们 的 索引 分 别 为 0.1 和 2。 调 
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用 类 似 getX() 的 方法 必须 使 用 触 点 索引 作为 参数 才 可 以 获得 指定 的 触 点 信息 。 

触 点 ID 也 是 一 个 整数 ,可 以 表示 哪个 触 点 被 跟踪 。 当 第 一 个 手指 触摸 屏幕 时 , 触 点 
ID 也 是 从 0 开始 的 ,但 是 随 着 手指 从 屏幕 上 的 移 走 或 放下 ,当前 这 个 值 就 有 可 能 不 是 从 0 
开始 。 这 是 由 于 Android 系统 使 用 触 点 ID 作为 跟踪 屏幕 上 不 同 手指 的 运动 , 触 点 ID 可 
以 固定 地 指定 某 个 手指 。 为 了 说 明 这 一 点 ,假设 由 两 个 手指 产生 的 一 对 触摸 序列 。 序 列 
产生 的 过 程 为 : 首先 从 手指 1 触摸 开始 ,然后 是 手指 2 触摸 ;接着 手指 1 移 走 ,然后 手指 2 
移 走 。 手 指 1 触摸 时 ,会 得 到 触 点 ID 为 0, 手指 2 触摸 时 ,会 得 到 触 点 ID 为 1, 而 它们 的 
和 触 点 索引 也 相同 。 当 手指 1 移 走 时 ,手指 2 的 ID 仍然 为 1, 而 这 时 手指 2 的 触 点 索引 就 
会 变 成 0, 这 就 是 上 面 说 的 触 点 索引 始终 从 0 开始 。 这 样 就 可 以 在 应 用 程序 里 使 用 触 点 
ID 将 触摸 事件 与 特定 的 手指 关联 起 来 ,以 及 涉及 的 其 他 手指 。 

在 一 个 手势 中 ,可 以 使 用 getPointerId() 方 法 获得 触 点 ID, 用 来 在 后 续 的 触摸 事件 中 
跟踪 手指 。 发 生 一 系列 的 动作 后 ,可 以 使 用 findPointerInder() 方 法 找到 触 点 ID 当前 对 
应 的 触 点 索引 ,然后 使 用 触 点 索引 获取 触摸 事件 的 信息 ( 见 代码 9. 5)。 

代码 9.5 使 用 getPointerId() 方 法 


Public boolean onTouchEvent (MotionEvent event) { 
//Get the pointer ID 
mActivePointerId= event .getPointerId (0); 


//… Many touch events later… 


//Use the pointer ID to find the index of the active Pointer 
/Vand fetch its position 
int pointerIndex= event .findPointerIndex (mActivePointerId); 
//Get the pointer's current position 
float x= event .getX (pointerIndex); 
float y= event .getY (pointerIndex); 

} 


另外 ,可 以 使 用 getActionMarked() 方 法 获得 触摸 事件 的 动作 。 与 getAction() 方 法 
不 同 , 这 个 方法 是 为 多 点 触 控 定义 的 。 这 个 方法 的 返回 结果 经 过 掩 码 处 理 ,去 掉 了 和 触 点 索 
引 的 信息 。 可 以 使 用 getActionIndex() 方 法 返回 触摸 事件 的 触 点 索引 ( 见 代 码 9. 6) 。 

代码 9.6 使 用 getActionMasked() 方 法 

int action= MotionEvent .getActionMasked (event); 
//Get the index of the pointer associated with the action 
int index— MotionEvent..getActionIndex (event); 


\®S 
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9.5 手势 识别 


手势 也 是 一 组 触摸 事件 的 序列 ,由 基本 和 触摸 事件 的 动作 组 成 。 手 势 可 以 是 简单 的 触 
摸 事件 序列 ,例如 单 击 、 滑 屏 等 ,也 可 以 是 自 定义 更 复杂 的 触摸 事件 序列 。 基 本 的 手势 包 
括 单 击 \ 长 按 、 滑 动 . 拖 动 、 双 击 、 缩 放 操 作 。 每 种 手势 都 是 用 户 的 一 种 特定 动作 ,触摸 屏 可 
以 识别 这 些 动作 完成 相应 的 功能 。 滑 动 就 是 手指 在 屏幕 上 拖 动 一 个 物体 ,快速 地 朝 一 个 
方向 移动 ,然后 抬 起 。 在 浏览 图 片 的 应 用 中 会 用 到 这 种 手势 。 当 用 户 滑 动 触摸 屏 时 ,新 的 
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图 片 就 会 显示 。 


Android 提供 了 GestureDetector 类 检测 一 些 常见 的 手势 ,其 中 的 方法 包括 onDown()、 
onLongPress() 和 onFling() 等 。 另 外 使 用 ScaleGestureDetector 类 来 实现 缩放 手势 。 


951 发 现 手势 


当初 始 化 GestureDetector 对 象 时 ,需要 传人 一 个 实现 了 OnGestureListener 接口 的 
参数 , 当 一 个 特定 的 手势 被 识别 时 ,就 会 执行 OnGestureListener 中 的 各 种 手势 的 处 理 方 
法 。 为 了 使 GestureDetector 对 象 能 够 接收 和 触摸 事件 ,需要 覆盖 View 或 Activity 的 
onTouchEvent 方法 ,并 将 所 有 的 触摸 事件 传递 到 GestureDetector 对 象 中 ( 见 代码 9. 7) 。 

代码 9.7 使 用 GestureDetector 类 识别 手势 
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retum true; 
} 


@ Override 
// 双 击 的 按 下 跟 抬 起 各 触发 一 次 
Public boolean onDoubleTapEvent (VMotionEvent event) { 
Iog.d(CEBUG TAG, "onDoubleTapEvent: "+ event.tostring()); 
retum true; 
1 


@ Override 
// 单 击 确认 , 即 很 快 地 按 下 并 抬 起 ,但 并 不 连续 单 击 第 二 下 
Public boolean onSingleTapConfirmed (MotionEvent event) { 
Iog.d(CEBUS TAG, "onSingleTapConfinmed: "+ event.toString()); 
retum true; 


1 


在 代码 9.7 中 ,如 果 OnGestureListener 中 方法 执行 的 结果 为 true, 表 明 已 经 处 理 触 
摸 事件 ;如 果 为 false, 则 触摸 事件 继续 传递 ,直到 成 功 处 理 为 止 。 

如 果 只 想 处 理 部 分 手势 ,可 以 继承 SimpleOnGestureListener。SimpleOnGestureListener 
实现 了 OnGestureListener 接口 的 所 有 方法 ,而 且 返 回 值 都 为 false。 因 此 只 需要 覆盖 那 
些 关 心 的 方法 就 行 了 。 不 论 是 否 使 用 OnGestureListener, 最 好 的 做 法 就 是 实现 onDown() 
方法 ,并 返回 true。 这 是 因为 所 有 的 手势 都 需要 判断 onDown() 方 法 的 返回 值 ,如 果 在 
onDown() 中 返回 false( 这 是 SimpleOnGestureListener 中 的 默认 返回 结果 ) ,系统 认为 忽 
了 略 剩 余 的 手势 动作 ,SimpleOnGestureListener 中 的 其 他 方法 不 会 被 调用 。 
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从 Android 2. 2 开始 引入 了 ScaleGestureDetector 类 ,这 个 可 以 用 来 识别 缩放 手势 。 
缩放 手势 有 两 种 操作 ,一 种 是 两 个 手指 同时 触摸 屏幕 ,向 相互 远离 的 方向 移动 ,然后 同时 
离开 屏幕 ,这 是 放大 的 操作 ; 另 一 种 是 两 个 手指 同时 触摸 屏幕 ,向 相互 靠近 的 方向 移动 , 然 
后 同时 离开 屏幕 ,这 是 缩小 操作 。 

下 面 使 用 例子 来 说 明 如 何 使 用 缩放 手势 ,来 缩放 一 个 图 标 文件 。 首 先 定义 XML 布 
局 文件 ( 见 代 码 9. 8) 。 
代码 9.8 scale_detector_layout. xml 


< ?anl version= "1 .0" encoding= "utf- 8"2> 

< LinearLayout xmlns:android= "http://schemas.android.com/apk/res/android" 
android:id= "@ + id/layout" 
android:layout width= "fill parent" 
android:layout height= "fill parent" 
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代码 9. 8 布局 文件 中 使 用 ImageView 控件 定义 一 个 图 片 源 ,而 且 定 义 了 一 种 矩阵 缩 
放 的 方式 。 这 个 图 片 的 大 小 是 填充 布局 ,这 样 图 片 不 会 被 ImageView 的 边界 剪 切 。 代 码 
9.9 是 具体 实现 缩放 手势 的 Activity 代码 。 

代码 9.9 实现 缩放 手势 


aa 


@ Override 
Public boolean onScale (ScaleGestureDetector detector) { 
mScaleFactor * =detector.getScaleFactor (); 


//Make sure we don't get too small or too big 
mScaleFactor= Math.max (0.1f, Math.min (mScaleFactor, 5.0f)); 


Log.v (ThS, "in onScale, scale factor= "+ mScaleFactor); 
matrix.setScale (mScaleFactor, mScaleFactor); 


image.set ImageMatrix (Matrix); 
image.invalidate (); 
retum true; 


} 


代码 9. 9 在 onCreate() 中 ,获取 了 ImageView 和 ScaleGestureDetector 对象。 覆盖 
Activity 的 onTouchEvent() 方 法 。 在 这 个 方法 中 ,将 所 有 触摸 事件 传递 给 ScaleGesture- 
Detector 的 onTouchEvent() 方 法 ,并 且 结果 返回 true。 这 样 Activity 的 onTouchEvent() 
方法 可 以 不 断 地 获得 新 的 事件 ,并 把 事件 传递 给 ScaleGestureDetector, 通 过 所 获得 所 有 
的 触摸 事件 ,识别 出 缩放 手势 。 

例子 中 ,在 自 定义 ScaleListener 的 onScale() 方 法 中 实现 图 片 的 缩放 。 实 际 上 ， 
OnScaleGestureListener 监听 器 中 有 onScaleBegin() .onScale() 和 onScaleEnd() 三 个 回 
调 方 法 ,分别 表示 手势 开始 .进行 和 结束 三 个 过 程 。 

在 onScale() 方 法 中 传人 ScaleGestureDetector 对 象 , 可 以 得 到 很 多 关于 缩放 操作 的 
信息 。mScaleFactor 是 缩放 因子 ,在 1 的 上 下 区 间 ( 最 小 值 为 0. 1, 最 大 值 为 5. 0) 浮 动 。 
当 两 个 手指 靠近 时 ,此 值 会 小 于 1; 当 两 个 手指 分 开 时 ,此 值 会 大 于 1。mScaleFactor 的 值 
从 1 开始 , 随 着 手指 的 靠近 或 分 开 , 图 片 逐 渐变 小 或 变 小 。 如 果 mScaleFactor 等 于 1 ,图 
片 是 正常 的 大 小 。 还 为 mScaleFactor 设置 了 最 小 值 和 最 大 值 ,防止 图 片 过 小 或 过 大 。 


9.6 拖 放 处 理 


在 对 触摸 屏 操作 中 ,将 对 象 拖 鼻 穿 过 屏幕 是 常用 的 操作 。 如 果 Android 系统 是 
Android 3.0 或 以 上 的 版 本 ,可 以 使 用 Android 的 拖 放 框架 ,使 用 拖 放 事件 监听 器 View 
. OnDragListener 来 实现 。 

使 用 Android 的 拖 放 框架 ,允许 用 户 通过 一 个 图 形 化 的 拖 放手 势 ,把 数据 从 当前 布局 
中 的 一 个 视图 上 转移 到 另 一 个 视图 上 。 这 个 框架 包含 了 一 个 拖 动 事件 类 , 拖 动 监听 器 和 
一 些 辅助 的 方法 和 类 。 

虽然 这 个 框架 主要 是 为 了 数据 的 移动 而 设计 的 .但 是 可 以 将 这 些 移动 的 数据 提供 给 
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其 他 的 UI 操作 使 用 。 例 如 ,可 以 创建 一 个 当 用 户 把 一 个 彩色 图 标 拖 到 另 一 个 彩色 图 标 
上 时 ,将 颜色 混合 起 来 的 应 用 。 
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当 用 户 执行 一 些 被 当 作 是 开始 拖 动 数据 的 信号 的 手势 时 ,一 个 拖 放 动作 就 开始 了 。 
作为 回应 ,应 用 程序 告诉 系统 拖 动 动作 开始 了 。 系 统 回 调 应 用 程序 ,获取 正在 被 拖 动 图 形 
的 数据 ,创建 一 个 拖 动 图 形 的 暗色 代表 图 形 , 称 为 拖 动 阴 影 。 当 用 户 的 手指 将 拖 动 阴影 移 
动 到 当前 布局 上 时 ,系统 创建 发 送 拖 动 事件 ,并 传递 给 拖 动 事 件 监听 器 对 象 ,以 及 与 布局 
中 View 相 联系 的 拖 动 事件 回调 方法 。 一 旦 用 户 释放 这 个 拖 动 阴 影 ,系统 就 结束 拖 动 
操作 。 

Android 应 用 程序 在 处 理 拖 放 操作 时 ,可 以 通过 实现 View. OnDragListener 接口 , 创 
建 拖 动 事件 监听 器 。 然 后 通过 View 类 提供 的 setOnDragListener() 方 法 ,为 View 对 象 
设置 一 个 拖 动 事件 监听 器 对 象 。 每 个 View 对 象 都 可 以 有 一 个 onDragEvent() 回调 方法 。 

应 用 程序 通过 调用 View. OnDragListener 的 startDrag() 方 法 告诉 系统 开始 一 个 拖 
动 ,也 就 是 告诉 系统 可 以 开始 发 送 拖 动 事件 。 一 旦 应 用 程序 调用 startDrag() 方 法 , 剩 下 
的 过 程 就 是 使 用 系统 发 送 给 布局 中 的 视图 对 象 的 事件 。 


9.6.1.1 拖 放 过 程 


拖 放 过 程 包括 以 下 4 个 基本 步骤 或 状态 。 

1. 开始 

为 了 响应 用 户 开始 拖 动 的 手势 ,应 用 程序 通过 调用 startDrag() 方 法 告诉 系统 开始 一 
个 拖 动 动作 。startDrag() 的 参数 提供 被 拖 动 的 数据 ,描述 被 拖 动 数据 的 元 数据 以 及 一 个 
绘制 拖 动 阴影 的 回调 方法 。 

系统 首先 通过 回调 应 用 程序 去 获得 一 个 拖 动 阴 影 。 然 后 将 这 个 拖 动 阴影 显示 在 设备 
上 。 接 着 ,系统 发 送 一 个 操作 类 型 为 ACTION_DRAG_STARTED 的 拖 动 事件 ,给 当前 
布局 中 的 所 有 视图 对 象 的 拖 动 事件 监听 器 。 为 了 继续 接收 拖 动 事件 ,包括 一 个 可 能 的 拖 
动 事件 , 拖 动 事件 监听 器 必须 返回 true。 

如 果 拖 动 事件 监听 器 返回 值 为 false, 那 么 在 当前 操作 中 就 接收 不 到 拖 动 事件 ,直到 
系统 发 送 一 个 操作 类 型 为 ACTION_DRAG_ENDED 的 拖 动 事件 。 通 过 发 送 false, 监 听 
器 告诉 系统 它 对 拖 动 操作 不 感 兴趣 ,并 且 不 想 接收 被 拖 动 的 数据 。 

2. 继续 

用 户 继续 拖 动 。 当 拖 动 阴影 和 视图 对 象 的 边界 框 相 交 时 ,系统 会 发 送 一 个 或 多 个 拖 
动 事件 给 视图 对 象 的 拖 动 事件 监听 器 ,当然 该 事件 监听 器 已 经 注册 。 作 为 回应 ,监听 器 可 
以 选择 改变 响应 拖 动 事件 的 视图 对 象 的 外 观 。 例 如 ,如 果 事 件 表明 阴影 已 经 进入 了 视图 
的 边界 框 (操作 类 型 为 ACTION_DRAG_ENDED) ,那么 监听 器 就 可 以 高 亮 视图 以 作出 
回应 。 

3. 释放 

用 户 在 可 以 接收 数据 的 视图 的 边界 框 内 释放 拖 动 阴影 。 系 统 发 送 一 个 操作 的 类 型 为 
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ACTION_DROP 拖 动 事件 给 视图 对 象 的 监听 器 。 这 个 拖 动 事件 包括 调用 startDrag() 方 
法 传 给 系统 的 数据 。 如 果 接 收 释放 动作 的 代码 执行 成 功 ,那么 这 个 监听 器 会 被 期 望 返 回 
true 给 系统 。 

值得 注意 的 是 ,只 有 接收 拖 动 事件 的 视图 已 经 注册 了 监听 器 ,用 户 在 这 个 视图 的 边界 
框 内 释放 这 个 拖 动 阴影 时 ,ACTION_DROP 事件 才 会 发 生 。 如 果 用 户 在 其 他 情况 下 释 
放 这 个 拖 动 阴影 ,ACTION_DROP 的 拖 动 事件 就 不 会 被 发 送 。 

4. 终止 

在 用 户 释 放 拖 动 阴影 并 且 系 统 发 送出 一 个 操作 类 型 为 ACTION_DROP 的 拖 动 事件 
之 后 ,系统 发 送出 一 个 操作 类 型 为 ACTION_DRAG_ENDED 的 事件 来 表明 这 个 拖 动 操 
作 已 经 结束 。 不 管用 户 在 哪里 释放 这 个 拖 动 阴影 ,这 个 步骤 都 会 发 生 。 这 个 事件 会 发 送 
给 每 一 个 被 注册 为 接收 拖 动 事件 的 监听 器 ,无 论 是 否 其 接收 了 拖 动 视图 。 


9.6.1.2 拖 放 事件 


用 户 界面 的 视图 对 象 通过 实现 View. OnDragListener 接口 的 拖 动 事件 监听 器 ,或 通 
过 它 自身 的 onDragEvent(DragEvent) 回 调 方法 来 接收 拖 动 事件 。 当 系统 回调 这 个 方法 
或 监听 器 时 ,会 传递 给 它们 一 个 拖 动 事件 的 对 象 。 在 Android 系统 中 ,使 用 DragEvent 类 
来 描述 拖 动 事件 。 

在 大 多 数 情况 下 ,可 能 会 想 要 使 用 监听 器 。 因 为 实现 一 个 监听 器 类 ,可 以 在 儿 个 不 同 
的 视图 对 象 中 使 用 它 。 当 然 ,也 可 以 将 这 个 监听 器 类 作为 一 个 匿名 内 部 类 去 实现 。 实 现 
后 的 监听 器 需要 在 视图 对 象 上 注册 ,该 对 象 才能 够 接收 监听 到 拖 动 事件 。 注 册 监听 器 可 
以 通过 调用 视图 的 setOnDragListener() 这 个 方法 来 实现 。 

视图 对 象 可 以 同时 有 一 个 监听 器 和 一 个 回调 方法 。 如 果 在 这 种 情况 下 ,系统 会 首先 调 
用 监听 器 。 除 非 监听 器 返回 的 是 false, 要 不 然 系 统 不 会 去 调用 回调 方法 。onDragEvent 
(DragEvent) 方 法 和 View. OnDragListener 的 结合 跟 触 屏 事 件 的 onTouchEvent() 与 
View. OnTouchListener 的 结合 是 相似 的 。 

当 拖 动 事件 发 生 时 ,系统 创建 一 个 DragEvent 对 象 ,并 传递 给 相应 的 回调 方法 或 监 
听 器 。 这 个 对 象 包括 拖 放 事 件 中 正在 发 生 事件 的 类 型 以 及 其 他 依赖 这 个 事件 类 型 的 数 
据 。 监 听 器 调用 getAction() 这 个 方法 就 可 以 获得 这 个 事件 类 型 ( 见 表 9-2) 。 

表 9-2 DragEvent 的 事件 类 型 
getAction() 的 值 意 党 
在 应 用 程序 调用 startDrag() 并 获得 一 个 拖 动 阴影 之 后 ,视图 对 象 
的 拖 动 事件 监听 器 就 会 接收 到 这 个 事件 类 型 的 事件 


当 拖 动 阴影 刚刚 进入 视图 的 边界 框 范围 时 ,视图 的 拖 动 事件 监听 
器 就 会 接收 到 这 个 action 类 型 的 事件 。 这 是 当 拖 动 阴影 进入 视图 
ACTION_DRAG_ENTERED 的 边界 框 范围 时 监听 器 所 接收 到 的 第 一 个 事件 操作 类 型 。 如 果 
监听 器 还 要 继续 为 拖 动 阴影 进入 视图 边界 框 范围 之 内 的 动作 接 
收 拖 动 事件 ,那么 必须 返回 true 给 系统 


ACTION_DRAG_STARTED 
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getAction() 的 值 意 义 


当 拖 动 阴影 还 在 视图 的 边界 框 范围 中 ,视图 的 拖 动 事件 监听 器 就 
ACTION_DRAG_LOCATION 会 在 接收 到 ACTION_DRAG_ENTERED 事件 之 后 接收 到 这 个 操 
作 类 型 的 事件 


当 视 图 的 拖 动 事件 监听 器 接收 到 ACTION_DRAG_ENTERED 这 
个 事件 ,并 且 至 少 接收 到 一 个 ACTION_DRAG_LOCATION 事 
件 ,那么 在 用 户 把 拖 动 阴影 移 除 视 图 的 边界 框 范围 之 后 ,该 监听 
器 就 会 在 接收 到 这 个 操作 类 型 的 事件 


当 用 户 在 视图 对 象 上 释放 拖 动 阴影 时 ,该 视图 对 象 的 拖 动 事件 监 
听 器 就 会 接收 到 这 个 类 型 的 拖 动 事件 。 这 个 操作 类 型 只 会 发 送 
给 在 回应 ACTION_DRAG_STARTED 类 型 的 拖 动 事件 中 返回 
ACTION_DROP true 的 那个 视图 对 象 的 监听 器 。 如 果 用 户 释放 拖 动 阴影 的 那个 视 
图 没有 注册 监听 器 ,或 者 用 户 在 当前 布局 之 外 的 任何 对 象 上 释放 
了 拖 动 阴影 ,那么 这 个 操作 类 型 就 不 会 被 发 送 

如 果 释 放 动 作 顺 利 ,监听 器 应 该 返回 true, 否 则 应 该 返回 false 


当 系 统 结束 拖 动 动作 时 ,视图 对 象 的 拖 动 事件 监听 器 就 会 接收 到 
这 个 类 型 的 拖 动 事件 。 这 种 操作 类 型 不 一 定 是 前 面 有 一 个 
ACTION_DROP 事件 。 如 果 系 统 发 送 一 个 ACTION_DROP ,并 
ACTION_DRAG_ENDED 接收 到 一 个 ACTION_DRAG_ENDED 操作 类 型 ,并 不 意味 着 拖 
动 事件 的 成 功 。 监 听 器 必须 调用 getResult() 方 法 来 获取 在 回应 
ACTION_DROP 事件 中 返回 的 结果 。 如 果 ACTION_DROP 事件 
没有 被 发 送 , 那 么 getResult() 就 返回 false 


续 表 


ACTION_DRAG_EXITED 


9.6.1.3 拖 放 阴 影 


在 拖 动 过 程 中 ,系统 会 显示 一 张 用 户 拖 动 的 图 片 。 对 数据 移动 而 言 , 这 张 图 片 代 表 着 
那些 正在 被 移动 的 数据 。 对 其 他 操作 而 言 ,这 张 图 片 代表 着 拖 动 操作 的 某 些 环节 。 这 张 
图 片 就 被 叫做 一 个 拖 动 阴影 。 

拖 动 阴影 可 以 通过 在 View. DragShadowBuilder 中 定义 的 方法 创建 ,并 调用 应 用 程 
序 定义 的 View. DragShadowBuilder 里 面 的 回调 方法 去 获取 一 个 拖 动 阴影 。 

View. DragShadowBuilder 类 有 如 下 两 个 构造 方法 。 

(1) View. DragShadowBuilder(View) : 此 构造 方法 接收 应 用 程序 中 的 任意 一 个 视图 
对 象 , 并 将 此 视图 对 象 存储 View. DragShadowBuilder 对 象 中 。 因 此 在 回调 过 程 中 ,可 以 
直接 把 它 作 为 拖 动 阴影 。 构 造 方法 不 必 和 用 户 选择 开始 一 个 拖 动 的 视图 对 象 (如 果 有 ) 相 
关联 。 

如 果 使 用 这 个 构造 方法 ,不必 去 继承 View. DragShadowBuilder 类 或 覆盖 它 的 方法 。 
默认 情况 下 ,会 得 到 一 个 与 作为 参数 传递 的 那个 视图 有 相同 外 表 的 拖 动 阴影 ,并 且 该 拖 动 
阴影 会 居中 位 于 用 户 接触 的 屏幕 上 。 

(2) View. DragShadowBuilder() : 如 果 使 用 这 个 构造 方法 ,在 View. DragShadowBuilder 
对 象 中 没有 一 个 视图 对 象 是 有 效 的 (这 个 字段 被 设置 为 null) 。 如 果 使 用 该 构造 方法 ,不 
必 继 承 View. DragShadowBuilder 类 或 覆盖 它 的 方法 ,可 以 得 到 一 个 不 可 见 的 拖 动 阴影 。 
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系统 不 会 给 出 一 个 错误 。 

View. DragShadowBuilder 类 有 如 下 两 个 方法 。 

(1) onProvideShadowMetrics(): 系统 在 调用 了 android. view. View. DragShadow- 
Builder. startDrag() 这 个 方法 之 后 ,立刻 回调 用 这 个 方法 。 用 这 个 方法 给 系统 发 送 拖 动 
阴影 的 规模 和 接触 点 。 这 个 方法 有 两 个 参数 ,其 中 dimensions 表示 一 个 Point 对 象 , 指 拖 
动 阴影 的 宽 为 x, 高 为 y; 另 一 个 参数 touch_point 表示 一 个 Point 对 象 , 指 拖 动 过程 中 ,在 
用 户 手 指 之 下 的 拖 动 阴影 的 位 置 ,X 轴 坐 标 为 x,Y 轴 坐 标 为 y。 

(2) onDrawShadow() : 在 调用 了 onProvideShadowMetrics() 方 法 之 后 ,系统 立刻 调 
用 onDrawShadow() 这 个 方法 来 获取 拖 动 阴影 。 这 个 方法 只 有 一 个 参数 ,一 个 Canvas 对 
象 ,该 对 象 是 系统 利用 提供 给 onProvideShadowMetrics() 方 法 里 面 的 参数 构造 出 来 的 。 
利用 它 可 以 在 提供 给 的 Canvas 对 象 中 绘制 的 拖 动 阴影 。 

962 设计 拖 动 操作 

这 一 部 分 说 明 如 何 开 始 一 个 拖 动 ,如 何在 拖 动 过 程 中 回应 事件 ,如 何 回 应 一 个 拖 动 事 
件 以 及 如 何 结束 一 个 拖 放 操作 。 

1. 开始 拖 动 

用 户 用 一 个 拖 动 的 手势 开始 一 个 拖 动 ,通常 是 一 个 在 视图 对 象 上 的 长 按 动作 。 作 为 
回应 ,需要 做 下 面 两 件 事 情 。 

。 为 要 移动 的 数据 创建 一 个 ClipData 和 ClipData. Item 对 象 。 

当 用 户 在 一 个 视图 上 有 一 个 长 按 动作 时 ,需要 创建 一 个 ClipData 和 ClipData. Item 
对 象 ,用 于 存储 在 ClipDescription 对 象 中 的 元 数据 。 因 为 一 个 拖 放 动 作 不 能 表示 数据 的 
移动 ,可 使 用 null 来 代替 一 个 实际 的 数据 。 

例如 ,下 面 一 个 例子 说 明了 当 在 ImageView 上 有 一 个 长 按 动 作 事件 时 ,如 何 创建 一 
个 ClipData 对 象 ,来 包含 这 个 ImageView 的 标志 或 标签 。 以 下 就 是 这 些 片 段 , 第 二 个 片 
段 说 明了 如 何 重 写 View. DragShadowBuilder 这 个 类 中 的 方法 。 

代码 9.10 创建 ClipData 对 象 


//Create a string for the ImageView label 
private static final String IMAGEVIEW TAG= "icon bitrap" 


//Creates a new ImageView 
TmageView imageView= new ImageView (this); 
//Sets the bitmap for the ImageView from an icon bit map (defined elsewhere) 


imageView.setImageBitmap (mIoonBitmap); 


//Sets the tag 
imageView. set'Tag (IMnGEVIEN TPG) 


Ve 基于 Adoid 平 台 的 移动 互联 网 开发 


。 创建 拖 动 阴影 。 
创建 一 个 View. DragShadowBuilder 的 子 类 MyDragShadowBuilder, 覆盖 onDraw- 
Shadow() 方 法 和 onProvideShadowMetrics() 方 法 ,为 拖 动 一 个 TextView 创建 了 一 个 小 
的 灰色 矩形 框 拖 动 阴影 ( 见 代 码 9. 11) 。 
代码 9.11 覆盖 View. DragShadowBuilder 的 方法 
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其 中 ,onProvideShadowMetrics() 方 法 中 的 代码 实现 了 回调 方法 ,把 拖 动 阴影 的 位 置 
和 触摸 点 传递 给 系统 ; onDrawShadow 方法 的 代码 实现 了 回调 方法 ,基于 系统 根据 
onProvideShadowMetrics() 方 法 中 传递 的 位 置 , 所 构建 的 画布 上 画 拖 动 阴影 。 

这 个 继承 View. DragShadowBuilder 和 覆盖 其 方法 的 过 程 并 不 是 必需 的 ,构造 方法 
View. DragShadowBuilder(View) 会 创建 一 个 默认 的 拖 动 阴影 ,这 个 拖 动 阴影 与 传递 给 它 
的 View 参数 一 样 大 ,并 且 位 于 以 接触 点 为 中 心 的 位 置 。 

2. 响应 拖 动 开 始 事件 

在 拖 动 过 程 中 ,系统 将 拖 动 事件 传递 给 当前 布局 中 的 视图 对 象 的 拖 动 事件 监听 器 。 
监听 器 应 该 调用 getAction() 这 个 方法 获取 操作 类 型 。 在 一 个 拖 动 开始 时 ,这 个 方法 返回 
ACTION_DRAG_STARTED。 

当 ACTION_DRAG_STARTED 事件 发 生 时 ,监听 器 需要 进行 下 面 的 处 理 。 

。 调用 getClipDescription() 方 法 获取 ClipDescription 。 

使 用 在 ClipDescription 中 的 MIME 类 型 的 方法 查看 监听 器 是 否 接收 被 拖 动 的 数据 。 

如 果 拖 放 操作 没有 数据 移动 ,这 个 步骤 就 不 是 必需 的 。 
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。 如 果 监听 器 可 以 接收 一 个 拖 动 事件 , 它 必 须 返 回 true。 

所 谓 监听 器 可 以 接收 一 个 拖 动 事件 , 即 这 个 监听 器 可 以 对 拖 动 事件 进行 处 理 。 设 置 
返回 值 为 true, 告 诉 系 统 继续 发 送 拖 动 事件 给 监听 器 。 如 果 监 听 器 不 接收 一 个 拖 动 ,就 会 
返回 false, 系 统 就 会 停止 发 送 拖 动 事件 ,直到 ACTION_DRAG_ENDED 事件 发 生 。 

对 于 ACTION_DRAG_STARTED 事件 ,有 一 些 DragEvent 的 方法 是 无 效 的 ,例如 
getClipData() 、getX() .getY() 和 getResult() 。 

3. 在 拖 动 过 程 中 处 理事 件 

在 拖 动 过 程 中 , 当 监 听 器 对 ACTION_DRAG_STARTED 拖 动 事件 的 返回 值 为 true 
时 ,监听 器 继续 接收 后 续 的 拖 动 事件 。 监 听 器 在 拖 动 过 程 中 接收 到 的 拖 动 事件 类 型 取决 
于 拖 放 阴 影 的 位 置 以 及 监听 器 视图 的 可 见 性 。 

在 拖 动 过 程 中 ,getAction() 返 回 的 事件 类 型 包括 如 下 三 个 。 

(1) ACTION_DRAG_ENTERED: 当 接触 点 , 即 屏幕 上 位 于 用 户 手 指 下 的 那个 点 ， 
进入 监听 器 的 视图 的 边界 框 范围 内 时 ,监听 器 会 接收 到 这 个 事件 。 

(2) ACTION _DRAG _LOCATION: 一 旦 监听 器 接收 到 ACTION _DRAG _ 
LOCATION 事件 ,在 它 接收 到 ACTION_DRAG_EXITED 事件 之 前 ,接触 点 每 移动 一 
次 , 它 都 会 接收 到 一 个 新 的 ACTION_DRAG_LOCATION 事件 。 方 法 getX() 和 getY() 
会 返回 接触 点 的 X 轴 和 YY 轴 的 坐标 。 

(3) ACTION_DRAG_EXITED: 在 拖 动 阴影 不 再 位 于 监听 器 视图 的 边界 框 范围 之 
内 时 ,这 个 事件 会 被 发 送 给 以 前 接收 到 ACTION_DRAG_ENTERED 事件 的 监听 器 。 

当 这 些 事件 发 生 时 ,监听 器 可 以 不 对 任意 一 个 作出 反应 。 如 果 监 听 器 返回 一 个 值 给 
系统 , 它 也 会 被 忽略 掉 。 

4. 响应 释放 动作 

当 用 户 在 某 个 视图 上 释放 拖 动 阴影 时 ,该 视图 会 预先 报告 是 否 可 以 接收 被 拖 动 的 内 
容 , 系 统 会 将 拖 动 事件 分 发 给 具有 ACTION_DROP 操作 类 型 的 那个 视图 。 监 听 器 在 事 
件 处 理 时 ,需要 做 两 个 事情 。 

一 是 调用 getClipData() 方 法 获取 最 初 在 startDrag( ) 方 法 中 应 用 的 ClipData 对 象 ， 
并 存储 。 如 果 拖 放 操作 没有 数据 的 移动 ,就 不 必 进 行 这 个 操作 。 

另 一 个 是 ,如 果 释 放 动 作 已 顺利 完成 ,监听 器 应 返回 true; 如 果 没 有 完成 , 则 返回 
false。 这 个 被 返回 的 值 成 为 ACTION_DRAG_ENDED 事件 中 getResult() 方 法 的 返 
回 值 。 

需要 注意 的 是 ,如 果 系 统 没 有 发 送出 ACTION_DROP 事件 ,那么 ACTION_DRAG _ 
ENDED 事件 中 getResult() 方 法 的 返回 值 就 为 false。 

对 于 ACTION_DROP 事件 来 说 ,在 释放 动作 的 瞬间 .getX() 和 getY() 方 法 使 用 接收 
释放 动作 的 视图 上 的 坐标 系统 ,返回 拖 动 点 的 X 轴 和 YY 轴 的 坐标 。 

系统 允许 用 户 在 监听 器 不 接收 拖 动 事 件 的 视图 上 释放 拖 动 阴影 。 系 统 允许 用 户 在 应 
用 程序 UI 的 空 区 域 或 者 应 用 程序 之 外 的 区 域 释放 拖 动 阴影 。 

5. 回应 一 个 拖 动 的 结束 

用 户 释 放 了 拖 动 阴影 后 , 系统 会 立即 给 应 用 程序 中 所 有 的 拖 动 事 件 监 听 器 发 送 


第 9 章 触摸 事件 处 理 NA 
Se 


ACTION_DRAG_ENDED 类 型 的 拖 动 事件 ,表明 拖 动 动作 结束 了 。 

当 这 个 ACTION_DRAG_ENDED 事件 发 生 时 ,监听 器 需要 进行 下 面 的 处 理 : 如 果 
监听 器 在 操作 期 间 改变 了 View 对 象 的 外 观 , 应 该 把 View 对 象 重 置 为 默认 的 外 观 , 监 听 
器 向 系统 返回 true。 监 听 器 也 可 以 调用 getResult() 方 法 来 查找 更 多 的 相关 操作 。 如 果 
在 响应 ACTION_DROP 类 型 的 事件 中 监听 器 返回 了 true, 那 么 getResult() 方 法 也 会 返 
回 true。 在 其 他 的 情况 中 ,getResult() 方 法 会 返回 false, 包 括 系统 没有 发 出 ACTION_ 
DROP 事件 的 情况 。 


963 实现 拖 动 操作 


上 一 节 介 绍 了 如 何在 拖 放 操 作 的 各 个 阶段 对 事件 进行 处 理 , 下 面 使 用 一 个 简单 的 例 
子 来 说 明 如 何 实现 拖 放 操作 。 

实现 拖 放 操作 的 步 又 有 六 步 , 包 括 创建 应 用 程序 可 以 根据 实际 的 情况 删 减 步骤 。 

1. 定义 XML 绘制 图 片 

在 res 的 drawable 目录 下 ,创建 shape. xml 文件 ,作为 正常 的 背景 设置 ( 见 代码 9. 12) 。 
XML 文件 中 的 二 shape 过 元素 用 于 定义 形状 。 其 子 元 素 志 gradient 二 定义 该 形状 里 面 为 
渐变 色 填 充 ,startColor 表示 起 始 颜色 ,endColor 表示 结束 颜色 ,angle 表示 方向 角度 。 子 
元 素 二 stroke 二 定义 二 shape 二 中 线 的 属性 。 子 元 素 二 corners 二 为 这 个 shape 创建 圆 角 。 
只 有 当 形 状 为 矩形 时 才能 使 用 。 

另外 还 有 子 元 素 志 padding 二 用 于 填充 应 用 的 视图 对 象 (而 不 是 形状 ) , 子 元 素 志 size> 
用 于 定义 shape 的 尺寸 , 子 元素 二 solid 之 用 于 定义 填充 颜色 。 各 子 元 素 分 别 具 有 自己 的 
属性 ,可 以 根据 设计 来 设 定 。 

代码 9. 12 shape. xml 


< ?anl Versior= 叫 .0" encoding= "UTF- 8"2?> 
< shape xmlns:android= "http://schemas.android.comyVapk/res/android" 
android:shape= "rectangle"> 


< stroke 
android:width= "2dp" 
android:color= "#FEFFFFFF"/> 
< gradient 
android:angler "225" 
android:endcolor= "#DDOROCFA" 
android:startColor= 啡 DD000000"/> 
区 
android:topLeftRadius= "7dp" 
android:topRightRadius= "1dp"/> 


< /shape> 
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在 res 的 drawable 目录 下 ,创建 shape_droptarget. xml 文件 ,作为 当 被 拖 动 对 象 进 入 
到 目标 对 象 的 范围 内 后 ,目标 对 象 的 背景 ( 见 代码 9. 13) 。 
代码 9. 13 shape_droptarget. xml 


2. 定义 布局 等 资源 文件 

定义 Activity 显示 的 用 户 界面 main. xml 布局 文件 ,界面 使 用 网 格 布局 ,每 个 网 格 中 
使 用 前 面 定义 的 shape 形状 作为 背景 ,放置 一 个 图 片 ( 见 代码 9. 14 ) 。 

代码 9.14 布局 文件 


Sa 基于 wdoid 平 台 的 移动 互联 网 开发 


3. 创建 或 打开 Activity, 获 取 定 义 的 视图 对 象 
创建 DragActivity 作为 主 界面 ,导入 布局 文件 main. xml( 见 代码 9. 15) 。 
代码 9.15 主 Activity 


4. 定义 或 实现 TouchListener 

在 DragActivity 中 自 定义 一 个 OnTouchListener 的 监听 器 MyTouchListener, 当 接 
收 到 ACTION_DOWN 事件 时 ,创建 一 个 ClipData 对 象 ,使 用 View. DragShadowBuilder 
给 当前 所 触摸 的 对 象 创建 一 个 拖 动 阴影 ,设置 开始 拖 动 操作 ( 见 代码 9. 16) 。 
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代码 9.16 自 定义 OnTouchListener 


在 这 里 也 可 以 使 用 自 定义 OnLongClickListener 来 设置 开始 拖 动 操作 ,在 其 
onLongClick() 方 法 中 创建 ClipDate 对 象 , 创 建 拖 动 阴影 ,以 及 进行 其 他 的 相关 初始 
设置 。 

5. 定义 或 实现 DragListener 

在 DragActivity 中 自 定义 一 个 OnDragListener 的 监听 器 MyDragListener, 定 义 在 
拖 动 操作 时 ,各 事件 发 生 时 视图 对 象 的 工作 ( 见 代码 9. 17)。 当 ACTION_DRAG_ 
STARTED 发 生 时 ,因为 前 面 在 onTouch() 代 码 中 已 经 做 了 拖 动 开始 操作 时 的 一 些 处 
理 , 这 里 就 不 做 任何 处 理 了 ; 当 被 拖 动 的 对 象 进入 本 视图 对 象 的 ACTION_DRAG_ 
ENTERED 事件 发 生 时 ,将 背景 改变 为 shape_droptarget. xml 所 定义 的 图 片 ; 当 拖 动 释 
放 的 ACTION_DROP 事件 发 生 时 ,将 原来 的 拖 动 对 象 删除 ,加 入 到 所 拖 动 到 的 位 置 ; 当 
拖 动 操作 结束 的 ACTION_DRAG_ENDED 和 ACTION_DRAG_EXITED 事件 发 生 时 ， 
将 背景 改 回 shape. xml 定义 的 正常 背景 。 

代码 9.17 自 定义 OnDragListener 
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6. 将 监听 器 注册 到 视图 对 象 

在 DragActivity 中 ,使 用 findViewById() 方 法 ,获取 布局 文件 中 定义 的 图 片 对 象 ,并 
通过 视图 对 象 的 setOnTouchListener() 和 setOnDragListener() 方 法 ,将 前 面 所 定义 的 监 
听 器 对 象 注 册 到 视图 对 象 上 ,完成 整个 程序 的 编写 。 

代码 9. 18 DragActivity. java 
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ViewGroup owner= (ViewGroup) view.getParent (); 
Owner .removeView (view) 7 
LinearTayout container= (LinearTayout) v; 
container.addView (view) ; 
View.setVisibility (View.VISIBIE) ; 


9.7 小 结 


本 章 主 要 介绍 了 Android 系统 对 于 触摸 屏 的 操作 和 人 处理 。 

Android 系统 中 把 用 户 对 触摸 屏 的 操作 定义 成 不 同 的 手势 。 手 势 是 指 系统 可 识别 
的 ,用 户 在 对 屏幕 显示 对 象 操作 时 ,手指 在 触摸 屏 上 抬 起 、 按 下 或 是 移动 的 方式 。 在 
Android 系统 中 支持 的 核心 手势 包括 触摸 (Touch) ,长 按 (Long Press) 滑动 (Swipe) 、 拖 
电 (Drag)、 双 击 (Double Touch) .放大 (Pinch Open) 和 缩小 (Pinch Close) 。 

在 Android 系统 中 ,触摸 事件 由 MotionEvent 类 来 描述 。 产 生 一 个 触摸 事件 ,系统 就 
会 创建 一 个 MotionEvent 对 象 。 从 用 户 手指 触摸 设备 屏幕 开始 ,到 手指 离开 设备 屏幕 结 
东 ,Android 系统 会 产生 一 系列 与 手指 运动 相关 触摸 事件 ,每 个 触摸 事件 都 记录 手指 运动 
的 信息 , 称 这 些 触摸 事件 为 一 个 事件 序列 。 每 一 个 手势 都 是 一 个 事件 序列 。 

触摸 事件 的 处 理 遵循 触摸 事件 的 传递 和 消费 机 制 。 触 摸 事件 在 用 户 界面 的 View 和 
ViewGroup 的 相 邻 层 次 之 间 传递 ,传递 方向 先 从 外 向 内 ,然后 从 内 向 外 。 从 外 向 内 传递 
就 是 从 最 外 层 的 根 元 素 依次 递归 向 其 包含 的 子 元 素 传递 ,一 直到 最 内 层 子 元 素 ,或 中 间 某 
个 元 素 消费 了 触摸 事件 ,结束 了 传递 ;从 内 向 外 就 是 从 最 内 层 子 元 素 依次 递归 向 外 层 传 
递 ,直到 根 元 素 或 中 间 某 个 元 素 消费 了 触摸 事件 ,结束 了 传递 。 

对 于 触摸 事件 的 处 理 包括 速率 跟踪 、 多 点 触 控 、 手 势 识别 和 拖 放 处 理 。 事 件 处 理 遵循 
触摸 事件 的 传递 和 消费 机 制 , 具 体 实现 可 以 采用 事件 监听 的 方式 ,也 可 以 采用 回调 方法 的 
方式 处 理 。 
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10.1 定位 服务 


Android 通过 android. location 包 中 的 类 为 应 用 程序 提供 定位 服务 。 定 位 框架 中 的 
核心 组 件 就 是 LocationManager 系统 服务 ,其 提供 了 支撑 底层 设备 的 定位 API。 与 其 他 
系统 服务 一 样 ,并 不 是 直接 实例 化 一 个 LocationManager 对 象 ,而 是 通过 调用 Context 类 
的 getSystemService (Context，LOCATION SERVICE ) 方法 来 获得 一 个 
LocationManager 对 象 。 这 个 方法 会 返回 一 个 新 的 LocationManager 对 象 。 

应 用 程序 获取 一 个 LocationManager 对 象 后 ,就 可 以 进行 定位 服务 的 各 种 操作 ， 
例如 : 

。 查询 所 有 定位 提供 者 列表 ,获得 最 新 的 用 户 位 置信 息 。 

。 周期 性 地 注册 、 更 新 或 注销 用 户 当 前 位 置 。 

。 如 果 设 备 进入 到 一 个 给 定 经 度 和 纬度 邻近 范围 时 (指定 一 个 半径 ) 时 ,注册 或 注销 

一 个 需要 启动 的 Intent。 

使 用 Google 地 图 的 Android API, 可 以 使 用 Google 地 图 数据 ,将 地 图 功能 集成 到 应 
用 中 。API 自动 处 理 对 Google 地 图 服务 器 的 访问 、 数 据 下 载 、 地 图 显示 和 在 地 图 上 触 控 
手势 。 

Google 地 图 API 的 关键 类 是 MapView。MapView 是 从 Google 地 图 服务 器 上 获取 
数据 ,然后 显示 一 个 地 图 。 当 MapView 成 为 界面 焦点 时 ,MapView 可 以 捕捉 键盘 响应 和 
触 控 手势 ,并 且 移 动 和 自动 地 缩放 地 图 ,包括 为 男 外 的 地 图 块 处 理 网 络 请 求 。MapView 
也 可 以 提供 所 有 的 UI 元 素 ,使 用 户 可 以 控制 地 图 。 通 过 编程 ,应 用 可 以 使 用 MapView 
方法 控制 地 图 ,也 可 以 在 地 图 的 上 面 画 多 个 覆盖 物 。 但 是 Google 地 图 API 没有 包括 在 
Android 平 台中 ,可 以 通过 Google Play 服务 获得 API( 需 要 Android 2. 2 或 更 高 的 
版 本 )。 
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Android 设 备 获取 位 置 可 以 使 用 GPS 和 Android 网 络 位 置 提供 器 (Android 
Network Location Provider, NLP)。 尽 管 GPS 定位 更 精确 ,但 缺点 是 只 能 在 户外 使 用 、 
耗 电 严重 ,并 且 其 返回 用 户 位 置 的 速度 远 不 能 满足 用 户 需求 。 网 络 位 置 提供 器 通过 基站 
和 Wi-Fi 信号 来 获取 位 置信 息 , 并 且 室内 外 均 可 使 用 .其 速度 更 快 . 耗 电 更 少 。 为 了 获取 
用 户 位 置信 息 , 可 以 同时 使 用 GPS 和 Android 网 络 位 置 提供 器 ,也 可 以 二 者 任 选 其 一 。 
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1. 获取 位 置信 息 时 要 解决 的 问题 
那么 哪些 因素 决定 了 定位 呢 ? 获得 用 户 信 息 是 一 个 复杂 的 过 程 ,有 时 候 会 发 现 获取 
的 位 置信 息 是 错误 的 或 者 精度 不 高 ,原因 有 以 下 几 种 。 

。 多 种 位 置 源 : GPS、Cell-ID 和 Wi-Fi 都 可 以 提供 用 户 位 置信 息 , 每 种 源 的 精度 是 
不 同 的 ,但 是 决定 使 用 哪个 源 ,需要 权 衔 精度 .速度 和 电池 的 容量 。 

。 用 户 的 移动 : 当 用 户 移动 时 ,因为 用 户 位 置 的 改变 ,必须 经 常 定 期 获取 用 户 位 置 。 
所 以 当 用 户 在 移动 时 ,如 果 获取 信息 的 频次 越 高 , 则 用 户 位 置信 息 越 精确 ,但 是 高 
频次 也 会 影响 设备 的 运行 效率 和 电量 。 

。 变化 的 精度 : 从 每 个 位 置 源 获得 的 位 置 估算 在 精度 方面 也 是 不 一 致 的 。 例 如 ,从 
一 个 位 置 上 ,10 秒 前 获得 的 位 置 或 许 比 从 相同 的 或 者 不 同 的 源 上 获取 的 最 新 位 
置 精度 更 高 。 

2. 实现 定位 功能 的 重要 类 

在 使 用 位 置 服务 开发 应 用 时 ,上 面 这 些 因素 都 需要 考虑 。 但 首先 需要 知道 怎样 获取 

位 置信 息 。 以 下 是 android. location 包 中 几 个 关于 定位 功能 的 比较 重要 的 类 。 

。 LocationManager: 提供 访问 系统 定位 服务 。 定 位 服务 可 以 为 应 用 程序 提供 周期 
性 的 设备 的 地 理 位 置 更 新 信息 ,或 当 设 备 进 入 某 个 地 理 范围 时 ,发 送 应 用 程序 说 
明 的 Intent。 

。 LocationProvider: 是 一 个 抽象 类 ,是 不 同 定位 提供 者 的 父 类 ,提供 当前 位 置信 息 ， 
并 存储 在 Location 类 中 。Android 设备 有 一 些 可 用 的 LocationProvider, 表 10-1 
列 出 了 主要 的 LocationProvider。 


表 10-1 LocationProvider 


LocationProvider 描 述 
network 使 用 移动 网 络 或 Wi-Fi 来 确定 最 佳 位 置 , 在 室内 精度 比 GPS 高 
gps 使 用 GPS 接收 器 来 确定 最 佳 位 置 ,通常 比 网 络 精度 更 高 
passive 允许 参与 其 他 组 件 位 置 更 新 以 节省 能 源 


。 LocationListener: 提供 定位 信息 发 生 改变 时 的 回调 功能 。 必 须 事先 在 定位 管理 
器 中 注册 监听 器 对 象 。 
。 Criteria: 使 得 应 用 能 够 通过 在 LocationProvider 中 设置 的 属性 来 选择 合适 的 定 
位 提供 者 。 
3. 请 求 位 置 更 新 信息 
在 Android 中 ,可 以 通过 回调 的 方法 得 到 用 户 位 置 。 使 用 LocationManager 类 ,向 其 
requestLocationUpdates() 方 法 传人 一 个 LocationListener 对 象 ,就 可 以 获得 位 置 更 新 。 
在 LocationListener 中 ,必须 要 实现 响应 的 几 个 回调 方法 ,以 便当 用 户 位 置信 息 和 服务 状 
态 的 变化 时 LocationManager 调用 。 
代码 10. 1 使 用 一 个 简单 的 例子 ,说 明了 如 何 定义 一 个 LocationListener, 并 且 请 求 位 
置 更 新 。 
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代码 10.1 位 置 更 新 信息 获取 


//acqnire a reference to the system Iocation Manager 
LocationManager locatiorManager= 
(LocationManager) this.getSystemService (Context.LOCATION SERVICE); 
//Define a listener that responds to location updates 
LocationbListener locationListener= new LocationListener() { 
Public void onLocationChanged (Location location) { 
//Called when a new location is found by the network location provider 
makeUseOfNewLocation (locaticn)7 
} 


pblic void mStatushanged (String provider, int status, Bndle extras) {} 
Public void onProviderFnabled (String provider) {} 


Public void onproviderDisabled (String provider) {} 
bs; 


//Pegister the listener with the Iocation Manager to receive locaticn updates 
]ocaticrMenager.reqnestIocaticnUPdates (LocaticrManager.NETWCRK FFOVITER, 
0, 0, locationListener); 

在 requestLocationUpdates() 方 法 的 第 一 个 参数 是 位 置 服务 的 类 型 ,也 就 是 程序 通 
过 什么 来 获取 用 户 的 位 置信 息 ;第 二 个 参数 是 两 次 位 置 提醒 之 间 的 最 小 时 间 间 隔 ; 第 三 个 
参数 是 两 次 位 置 提醒 之 间 最 小 距离 间隔 (第 二 三 两 个 参数 都 为 0 表示 尽 可 能 频繁 的 请 求 
位 置信 息 ) ;第 四 个 参数 为 LocationListener。 例 如 每 隔 30 秒 钟 收集 一 次 GPS 信息 ,可 以 
用 下 面 的 代码 实现 : 

locationManager .requestIocationUpdates (LocationManager.GPS PROVITER, 

30* 1000, 0, myListenGPS); 

代码 10. 1 中 ,选择 的 位 置 服务 类 型 为 NETWORK_PROVIDER ,而 Android 系统 提 
供 两 种 位 置 服务 类 型 ,其 中 包括 : 

。 LocationManager. GPS_PROVIDER。 

。 LocationManager. NETWORK_PROVIDER。 

应 用 程序 如 果 要 使 用 这 两 种 方式 的 定位 服务 ,需要 通过 系统 设置 ,如 图 10. 1 所 示 。 

这 两 种 方式 的 区 别 是 什么 呢 ? GPS_PROVIDER 提供 精确 的 GPS 定位 ,但 在 室内 几 
乎 无 法 定位 而 导致 无 法 收集 信息 , 即 有 定位 盲区 。GPS 定位 基本 原理 是 测量 出 已 知 位 置 
的 卫星 到 用 户 接收 机 之 间 的 距离 ,然后 综合 多 颗 卫 星 的 数据 就 可 知道 接收 机 的 具体 位 置 。 
要 达到 这 一 目的 ,卫星 的 位 置 可 以 根据 星 载 时 钟 所 记录 的 时 间 在 卫星 星 历 中 查 出 ,所 以 使 
用 必须 在 户外 。 而 NETWORK_PROVIDER 为 网 络 定位 ,其 偏差 较 大 ,但 无 定位 盲区 ,只 


CD 
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整合 


10.1 系统 设置 位 置 服务 方式 


要 有 网 络 一 般 都 可 以 收集 到 。 网 络 定位 简单 来 说 就 是 当 接 入 Wi-Fi 就 使 用 Wi-Fi 定位 ， 
当前 接 入 2G 或 3G 网 就 是 基站 定位 ,实际 上 基站 和 Wi-Fi 有 单独 的 定位 方式 ,只 不 过 系 
统 都 封装 到 了 NETWORK_PROVIDER 方法 中 。 

除了 requestLocationUpdates() 方 法 ,LocationManager 类 还 提供 了 getLastKnown- 
Location() 方 法 ,来 获取 上 一 次 获取 到 的 位 置信 息 ,并 非 当 前 的 GPS 位 置信 息 。 

4. 用 户 权 限 设置 

为 了 从 NETWORK_PROVIDER 或 GPS_PROVIDER 获取 位 置 更 新 ,必须 声明 在 
应 用 程序 的 manifest 文件 中 声明 用 户 访问 的 ACCESS_COARSE_LOCATION 或 
ACCESS_FINE_LOCATION 权限 。 

代码 10.2 定位 服务 用 户 权限 设置 


<manifest …> 
< uses— Permissicn 
android:name= "android.pemmission.AOCESS FINE LOCATION"/> 


< /manifest> 


如 果 在 应 用 程序 中 同时 使 用 NETWORK_PROVIDER 和 GPS_PROVIDER ,就 只 需 
声明 ACCESS_FINE_LOCATION 权限 。ACCESS_COARSE_LOCATION 只 包含 
NETWORK_PROVIDER 的 权限 。 
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基于 位 置 的 应 用 可 谓 是 数不胜数 ,但 是 由 于 很 难 提供 最 佳 精 度 , 用 户 位 置 的 移动 ,多 
种 方法 获取 用 户 位 置 和 尽 可 能 减少 耗 电量 等 原因 ,使 得 获取 用 户 位 置 变 得 较为 复杂 。 既 
减少 电池 耗 电量 ,同时 又 获取 极 佳 用 户 位 置 . 必 须 定义 一 个 长 效 模型 来 解决 多 种 难题 ,说 
明 应 用 如 何 获 取 用 户 的 位 置 。 当 启动 或 停止 监听 位 置 更 新 ,或 使 用 缓存 位 置 数 据 时 ,此 模 
型 会 被 使 用 。 下 面 是 获取 用 户 位 置 的 典型 流程 : 
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(1) 启动 应 用 。 

(2) 一 段 时 间 后 ,开始 监听 定位 提供 者 获取 位 置信 息 。 

(3) 通过 去 除 不 够 准确 的 位 置 更 新 来 保持 以 最 佳 状态 去 获取 位 置信 息 。 

(4) 停止 监听 获取 位 置信 息 。 

(5) 采用 最 新 最 好 的 位 置 。 

图 10. 2 通过 使 用 时 间 线 展示 了 获取 用 户 位 置 更 新 的 流程 时 间 线 。 这 个 时 间 线 体现 
了 应 用 监听 用 户 位 置 更 新 的 各 个 时 间 段 和 各 个 时 间 段 发 生 的 事件 。 


NewWiFibased 
Listen for Cached GPS location is 
GPS and location is dismissed due to 
Network dismissed as larger error Stop listening 
updates too old estimates for updates 
| | 一 人 -人 一 全 @ 一 人 -人 @ 一 二 一 
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network fixis location is location of the location 
location is received obtained replaces isused inthe 
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图 10.2 获取 用 户 位 置 更 新 的 时 间 线 


在 接收 更 新 位 置信 息 的 这 段 时 间 , 需 要 对 一 些 关 键 点 做 出 如 下 决策 。 

。 决定 开始 监听 更 新 的 时 刻 。 

应 用 程序 可 以 一 启动 就 开始 监听 用 户 位 置 更 新 ,也 可 以 仅 当 用 户 触发 特定 的 条 件 时 
才 启 动 监听 。 但 是 要 清楚 地 意识 到 两 点 ,第 一 点 是 长 时 间 的 监听 位 置 更 新 可 能 导致 耗 电 
量 急剧 上 升 ,第 二 点 是 短 时间 的 监听 又 可 能 使 得 用 户 位 置 获取 的 准确 度 不 够 。 如 上 所 述 ， 
可 以 通过 调用 requestLocationUpdates() 开 始 监听 更 新 。 


LocationProvider locationProvider= LocatiorManager.NETIWORK PROVITER; 
// 或 者 ,使 用 LocaticrManager.GPS_PROVITER 
locationManager .requestLocationUpdates (locationProvider, 0, 0, locationListener); 


。 通过 最 后 可 知 位 置 快 速 修 正 。 

位 置 监听 器 接收 第 一 次 位 置 更 新 所 花费 的 时 间 长 得 可 能 让 用 户 难以 忍受 。 除 非 位 置 
监听 器 接收 到 一 个 更 精确 的 位 置信 息 ,应 用 程序 应 该 暂时 使 用 缓存 中 的 用 户 位 置信 息 , 这 
个 信息 可 以 通过 调用 getLastKnownLocation() 方 法 来 获取 。 


LocationProvider locationProvider= LocatiorManager.NETIWORK PROVITER; 

Ipcation lastKnownLocation= locationManager.getLastKnownLocation (locationProvider); 

。 决定 停止 监听 更 新 的 时 刻 。 

根据 应 用 程序 的 不 同 ,决定 什么 时 候 停止 监听 最 新 的 策略 可 能 非常 简单 ,也 可 能 十 分 
复杂 。 在 获取 位 置信 息 和 使 用 位 置信 息 之 间 加 入 一 点 时 间 的 延迟 ,可 能 提高 位 置 获取 的 
准确 度 。 持 续 监听 会 消耗 大 量 的 电量 ,因此 ,只 要 获取 了 所 需 的 信息 ,应 该 通过 调用 
removeUpdates() 停 止 监听 更 新 。 
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// 移 除 先前 添加 的 监听 
locationManager .removeUpdates (locationListener); 


。 保持 最 佳 的 估算 值 。 

最 新 获取 的 位 置信 息 可 能 是 最 精确 的 。 但 是 ,由 于 位 置 修正 的 精确 度 经 常 变化 ,最 新 
获取 到 的 位 置信 息 并 不 一 定 都 是 最 准确 的 。 因 此 ,需要 基于 一 些 规范 添加 选择 位 置信 息 
的 逻辑 ,这 些 规范 可 以 根据 具体 的 应 用 和 现场 测试 的 实例 不 同 而 有 所 变化 。 下 面 是 确认 
位 置 修正 可 以 采用 的 步骤 : 

(1) 检查 是 否 最 近 得 到 的 位 置信 息 明 显 比 以 前 的 新 。 

(2) 检查 位 置 精度 是 好 于 还 是 差 于 之 前 的 位 置信 息 。 

(3) 检查 最 新 的 位 置信 息 是 来 自 于 哪 一 个 提供 者 ,并 且 判 断 是 否 这 个 位 置信 息 相 比 
之 前 的 更 加 准确 可 靠 。 

代码 10. 3 是 符合 上 述 迎 辑 的 代码 实现 例子 ,说 明了 如 何在 应 用 程序 中 实现 预定 义 好 
的 策略 和 好 辑 。 

代码 10.3 位置 修正 判断 逻辑 


Private static final int TWO MINUTIES=1000 * 60 * 2; 
Ax 判 断 哪 一 种 位 置 读 取 方 式 比 当前 的 位 置 修复 更 加 的 准确 
x @param locaticn 新 位 置 
* @ param currentBestIocaticn 当前 的 位 置 ,此 位 置 需要 和 新 位 置 进行 比较 
Location currentBestLocation) { 
if (currentBestIocationr==null) { 
/AAA new location is always better than no location 
retum true; 
} 


// 检 查 最 新 的 位 置 是 比较 新 还 是 比较 旧 

long timeDelta= location.getTime ()- currentBestIocation.getTime (); 
boolean issignificantlyNewer= timeDelta> TWO MINUTES; 

boolean issignificantlyolder= timeDelta< - TWO_MINUTES; 

boolean isNewer= timeDelta> 0; 


// 如 果 当 前 的 位 置信 息 来 源 于 两 分 钟 前 ,使 用 最 新 位 置 ， 
// 因 为 用 户 可 能 移动 了 
if (issignificantlyNewer) { 

retum true; 


// 如 果 最 新 的 位 置 也 来 源 于 两 分 钟 前 ,那么 此 位 置 会 更 加 的 不 准确 
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。 调整 模型 来 保存 电量 和 数据 交换 : 当 测 试 应 用 程序 的 时 候 , 可 能 会 在 模型 是 要 提 
供 更 佳 的 位 置信 息 还 是 更 佳 的 效率 之 间 做 出 选择 调整 。 

。 减少 窗口 的 大 小 : 在 一 个 较 小 的 窗口 下 监听 位 置 更 新 ,意味 着 与 GPS 或 者 网 络 定 
位 服务 进行 更 少 的 交互 ,这样 就 可 以 保存 电池 电量 。 但 是 这 样 会 使 得 可 选 位 置 变 
少 ,从 而 导致 获取 最 佳 位 置信 息 变 得 困难 。 

。 减少 位 置 提供 者 的 更 新 频率 : 在 窗口 中 减少 更 新 出 现 的 频率 也 可 以 提高 电池 使 
用 效率 ,但 是 这 样 会 牺牲 精确 度 。 两 者 之 间 的 权衡 要 依赖 于 具体 的 实际 应 用 。 可 
以 通过 增加 requestLocationUpdates() 函数 的 第 二 个 和 第 三 个 参数 的 值 来 减少 更 
新 的 频率 。 
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。 仅 支 持 一 种 位 置信 息 提 供 者 : 根据 应 用 程序 的 使 用 场景 和 对 精度 的 要 求 , 也 许 只 
需要 在 网 络 定位 提供 者 和 GPS 之 间 选 择 一 种 提供 者 ,而 不 是 两 者 都 需要 。 只 和 
其 中 的 一 种 服务 进行 交互 可 以 大 大 地 减少 耗 电 的 可 能 性 。 
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在 开发 应 用 的 过 程 中 ,需要 对 获取 用 户 位 置 的 模型 进行 效率 测试 。 最 简单 的 测试 就 
是 使 用 Android 真 机 设备 。 但 是 ,如 果 没 有 一 个 真正 的 物理 设备 ,也 可 以 使 用 Android 虚 
拟 机 的 虚拟 位 置 进行 基于 用 户 位 置 的 测试 。 向 应 用 提供 模拟 位 置 数据 的 方法 主要 有 三 
种 : Eclipse .DDMS 或 者 模拟 器 控制 台 的 geo 命令 行 。 由 于 提供 模拟 位 置 数据 是 使 用 的 
GPS 的 数据 类 型 ,所 以 必须 使 用 GPS_PROVIDER 来 获取 位 置 更 新 ,否则 模拟 数据 无 法 
下 儿 。 

如 果 使 用 Eclipse, 选 择 Windows 一 ShowView 一 Other-~Emulator Control。 在 模拟 
器 控制 面板 上 ,进入 位 置 控 制 (Location Controls) 下 输入 GPS 坐标 ,GPX 文件 中 是 路 径 
回放 ,KML 文件 中 是 多 个 位 置 的 记录 。 确 认 在 设备 面板 下 已 经 有 个 设备 被 选择 ,查看 
Windows 一 ShowView 一 Other 一 Devices 可 以 获得 相关 的 信息 。 如 果 使 用 DDMS 工具 ， 
可 以 使 用 多 种 方法 模拟 位 置 数据 ,其 中 包括 ,向 设备 手动 发 送 独 立 的 经 纬度 ;使 用 GPX 文 
件 向 设备 发 送 的 一 系列 路 径 ; 使 用 KML 文件 向 设备 发 送 独 立 的 一 序列 化 的 路 径 位 置 。 
如 果 使 用 模拟 器 控制 台 的 geo 命令 行 发 送 模拟 位 置 数据 ,需要 在 Android 模拟 器 上 装载 
应 用 ,并 打开 sdk 下 的 tools 目录 下 打开 设备 终端 的 控制 台 ,连接 到 模拟 器 控制 台 : 


telnet localhost < console- port> 


然后 向 模拟 控制 台 发 送 位 置 数据 。geo fix 发 送 固定 的 geo 位 置 。 这 个 命令 接收 十 
进 制 的 经 度 和 纬度 ,和 一 个 可 选 的 海拔 (单位 m) ,例如 : 


geo fix- 121.45356 46.51119 4392 
geo nmea 发 送 一 个 NMEA 0183 句子 ,例如 : 


eo mmea $ GERMC, 081836, A, 3751.65, 5, 14507.36,E, 000.0, 360.0, 130998,011.3,E* GD 
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前 面 对 有 关 定 位 服务 的 位 置信 息 服 务 进行 了 阐述 ,下 面 使 用 一 个 简单 的 例子 把 这 些 
知识 连贯 起 来 。 这 个 例子 可 以 在 屏幕 上 显示 手机 设备 当前 位 置 的 经 纬度 , 当 按 下 按钮 时 ， 
屏幕 显示 出 当前 经 纬度 对 应 的 地 址 信息 。 下 面 是 具体 的 步骤 。 

(1) 设置 用 户 权 限 : 在 应 用 程序 的 AndroidManifest. xml 文件 中 ,添加 设置 访问 位 置 
提供 器 的 权限 内 容 ( 见 代码 10. 2) 。 

(2) 定义 布局 等 资源 文件 : 在 /res/layout 中 定义 用 户 界 面 的 布局 文件 activity_ 
main. xml, 在 界面 上 定义 一 个 按钮 show_address_button, 一 个 用 于 响应 从 位 置 提供 其 中 
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获取 当前 位 置信 息 后 ,在 界面 上 显示 当前 位 置 的 经 纬度 以 及 设备 所 在 的 地 址 。 

(3) 创建 或 打开 Activity, 获 取 视 图 对 象 : 创建 显示 用 户 界 面 的 Activity 子 类 Show- 
LocationActivity ,并 导入 activity_main. xml 定义 的 布局 文件 ,获取 按钮 对 象 ,并 分 别 赋值 
给 showAddrBtn 变量 。 

(4) 获取 LocationManager 对 象 : 从 系统 获取 LocationManager 对 象 ,并 创建 Criteria 
对 象 ,根据 其 精度 和 电池 耗 电量 的 标准 ,使 用 LocationManager 的 getBestProvider() 方 法 
选取 系统 最 符合 要 求 的 LocationProvider( 见 代码 10. 4)。 

代码 10.4 初始 化 提供 位 置 服务 的 对 象 


(5) 定义 自己 的 LocationListener: 在 ShowLocationActivity 中 创建 MyLocationListener 
实现 LocationListener 的 接口 , 当 位 置 发 生变 化 时 ,把 经 纬度 显示 在 屏幕 上 ( 见 代码 10. 5)。 
代码 10.5 自 定义 位 置 监听 器 
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(6) 将 MyLocationLister 注册 到 当前 的 LocationManager 对 象 : 在 ShowLocation- 
Activity 的 onResume() 方 法 中 注册 位 置 监听 器 ,并 设 定位 置 更 新 信息 获取 的 方式 和 间 
隔 ;在 onPause() 方 法 中 删除 监听 器 监听 位 置 更 新 信息 ,在 ShowLocationActivity 界面 处 
于 暂停 状态 时 减少 电池 耗 电 量 ( 见 代码 10. 6) 。 

代码 10.6 注册 监听 器 


(7) 定义 按钮 的 监听 器 。 在 ShowLocationActivity 的 onCreate() 方 法 中 使 用 匿名 内 
部 类 的 方式 ,定义 showAddrBtn 按钮 的 单 击 监听 器 ,通过 当前 的 经 纬度 获得 确切 的 地 址 。 
由 于 实现 经 纬度 与 地 址 转化 的 代码 比较 烦琐 ,定义 一 个 private 的 方法 getAddress() 来 实 
现 ( 见 代码 10.7) 。 

代码 10.7 经 纬度 转换 为 地 址 
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运行 ShowLocationActivity ,观察 结果 。 


10.2 谷歌 地 图 


基于 位 置 的 服务 (Location Based Service,LBS) 是 通过 电信 移动 运营 商 的 无 线 电 通 
信和 网 络 ( 如 GSM 网 .CDMA 网 ) 或 外 部 定位 方式 (如 GPS) 获 取 移 动 终端 用 户 的 位 置信 
息 , 即 地 理 坐标 ,在 GIS 平 台 的 支持 下 ,为 用 户 提供 相应 服务 的 一 种 增值 业务 。 由 于 LBS 
与 地 理 位 置 直接 相关 ,其 应 用 开发 都 离 不 开 地 图 。 

使 用 Google Maps Android API. 可 以 基于 Google Maps 的 数据 ,在 应 用 中 添加 地 图 
功能 。Google Maps Android API 可 以 自动 处 理 对 Google Maps 服务 器 的 访问 、 数 据 下 
载 . 地 图 显示 和 地 图 手势 的 事件 响应 。 这 些 API 还 支持 在 基础 地 图 上 添加 标记 、 多 边 形 
和 图 层 , 改 变 用 户 查 看 地 图 区 域 的 视角 。 这 些 对 象 给 地 图 位 置 提供 额外 的 信息 ,允许 用 户 
与 地 图 交互 。 

目前 ,在 PC 浏览 器 版 本 上 Google Map API 已 经 到 了 V3 版本。 在 Android 平台 上 ， 
Google 在 2012 年 12 月 份 推出 了 V2 版 本 ,替代 原来 V1 版 的 支持 。V2 版 本 改进 了 V1 
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版 本 只 能 继承 自 MapActivity 才能 显示 地 图 的 弱点 ,通过 提供 MapFragment 对 象 , 开 发 
者 可 以 将 地 图 像 一 个 普通 的 Fragment 一 样 , 嵌 入 到 自己 的 App 中 。 有 一 点 比较 遗憾 ， 
V2 版 本 要 求 的 API level 至 少 是 13, 一 些 低 版 本 的 设备 就 没 法 支持 了 。 

Google Maps Android API V2 中 的 MapView 类 是 Google 地 图 应 用 开发 中 最 关键 
的 类 。MapView 对 象 存储 来 自 Google Maps 的 数据 ,显示 地 图 ,并 对 地 图 上 的 键盘 和 手 
势 动作 事件 进行 响应 和 处 理 。 应 用 程序 中 如 果 要 在 地 图 上 又 加 图 层 , 也 要 使 用 MapView 
的 方法 来 实现 。 

在 Android 平 台中 ,并 不 包括 Google Maps Android API, 但 Android 2.2 版 本 及 以 
上 的 系统 ,可 以 通过 Google Play 服务 获取 。 要 把 Google Maps 集成 到 应 用 程序 中 ,其 基 
于 的 Android SDK 需要 安装 Google Play 服务 库 。 

这 一 节 下 面 的 内 容 着 重 介 绍 Google Maps Android API( 下 简称 Maps API) 中 重要 
的 类 ,以 及 如 何 使 用 Google Maps。 
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在 API 中 ,Maps 是 由 GoogleMap 和 MapFragment 类 来 描述 的 。 使 用 这 些 Maps 
API, 就 可 以 在 Android 应 用 程序 中 显示 出 与 直接 访问 Google 地 图 完全 相同 的 外 观 。 

1. GoogleMap 类 

GoogleMap 是 Maps API 的 主 类 ,是 所 有 与 地 图 操作 相关 方法 的 入 口 。 当 对 Map 对 
象 进行 操作 时 ,在 应 用 程序 中 根据 它 构建 地 图 对 象 。GoogleMap 对 象 不 能 使 用 构造 方法 
直接 创建 ,需要 使 用 应 用 程序 中 的 MapFragment 或 MapView 的 getMap() 获得 。 

GoogleMap 可 以 自动 处 理 下 面 的 操作 : 
连接 到 GoogleMaps 服务 。 
下 载 地 图 图 块 。 
。 在 设备 屏幕 上 显示 地 图 图 块 。 
。 变化 显示 控制 ,例如 平移 和 缩放 。 
响应 平移 和 缩放 手势 。 

2. MapFragment 类 

MapFragment 类 是 Fragment 类 的 子 类 ,MapFragment 对 象 作 为 地 图 的 容器 ,提供 
对 GoogleMap 对 象 的 访问 。 在 Android 用 户 界面 设计 中 使 用 Fragment 具有 很 大 的 灵活 
性 ,可 以 在 一 个 Activity 中 放置 多 个 Fragment ,创建 多 个 窗 格 的 显示 界面 ;同时 ,一 个 设 
计 好 的 Fragment 还 可 以 在 多 个 Activity 中 重用 。 

在 XML 布局 资源 文件 中 说 明 一 个 Fragment 组 件 , 可 以 使 用 一 fragment 二 元 素 添加 
到 XML 文件 中 。 

代码 10.8 MapFragment 布局 定义 
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MapFragment 类 会 自动 初始 化 地 图 系统 和 视图 ,但 由 于 初始 化 过 程 依赖 于 Google 
Play services APK ,初始 化 完成 的 时 间 无 法 确定 。 只 有 当 相 关 的 地 图 系统 已 经 装载 ， 
Fragment 中 相关 的 视图 存在 时 ,MapFragment 才能 使 用 getMap() 获 得 GoogleMap 对 
象 。 如 果 无 法 获得 GoogleMap 对 象 ,getMap() 方法 返回 空 值 。 

当 ViewLifecycleInFragment() 选 项 设置 时 ,MapFragment 可 以 调用 onDestroyView() 方 
法 删除 当前 视图 。 只 有 当 MapFragment 调用 onCreateView() 方 法 重新 创建 视图 后 ， 
MapFragment 才 有 效 。 

如 果 编 译 目标 早 于 API 12 之 前 的 应 用 程序 ,可 以 使 用 SupportMapFragment 类 获得 
相同 的 功能 ,但 是 必须 在 项 目 中 包括 Android 的 支持 库 。 

3. MapView 类 

MapView 类 是 View 类 的 一 个 子 类 ,允许 将 地 图 放 在 视图 中 。 视 图 是 屏幕 的 一 个 矩 
形 区 域 ,是 Android 应 用 程序 和 部 件 的 基本 构建 块 。 与 MapFragment 类 似 , MapView 也 
是 作为 地 图 容器 ,通过 GoogleMap 的 对 象 呈现 出 地 图 的 核心 功能 。 

如 果 使 用 MapView 类 ,必须 将 包含 这 个 视图 的 Activity 或 Fragment 的 生命 周期 中 
所 有 方法 的 代码 ,在 MapView 对 应 的 方法 中 同样 实现 。 例 如 ,一 个 MapView 是 一 个 
Activity 中 的 视图 对 象 , 此 MapView 则 必须 在 onCreate( ) 方 法 中 ,编写 与 这 个 Activity 
的 onCreate() 方 法 中 同样 的 代码 ;以 此 类 推 到 生命 周期 中 其 他 的 方法 。MapView 类 中 ， 
下 面 这 些 方 法 必须 要 与 其 上 层 的 Activity 或 Fragment 中 的 代码 一 致 。 


。 onCreate(Bundle) 。 


*。 onResume() 。 

*。 onPause() 。 

。 onDestroy() 。 

*。 onSaveJInstanceState() 。 

*。 onLowMemory() 。 

4. Marker 类 

Marker 类 是 用 于 表示 地 图 上 特定 点 的 图 标 ,可 以 称 为 标记 。Marker 不 会 随 着 地 图 
的 旋转 、 分 块 或 缩放 发 生 改 变 。Marker 对 象 具有 以 下 属性 : 

。 Anchor: 被 放置 在 标记 经 纬度 上 的 图 片 的 点 。 默 认 在 图 片 的 底部 , 偏 左 位置 。 

。 Position: 地 图 上 标记 的 经 纬度 ,可 以 改变 其 值 ,移动 标记 。 

。 Title: 用 户 单 击 标记 时 ,显示 文本 说 明 。 

。 Snippet: 在 title 下 显示 格外 信息 。 

。 Icon: 显示 标记 的 位 图 。 

。 Drag Status: 如 果 人 允许 用 户 拖 动 标记 .此 属性 设置 为 true。 

。 Visibility: 默认 值 为 true, 标 记 可 视 。 

下 面 是 一 个 在 地 图 上 添加 标记 的 例子 代码 。 

代码 10.9 添加 标记 


GoogleMap map=… //get a map 
//Pod a marker at San Francisco 
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Marker marker- map.addMarker (new MarkerOptions () 
-Positicn (new LatIng(37.7750, 122.4183)) 
-title ("San Franciscom 
"shippet ("Population: 776733")); 


Marker 类 的 使 用 会 在 这 一 章 后 面 详 述 。 
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10.2.2.1 安装 Google Play Service 


Google Play Services 是 Google 推出 的 新 的 平台 ,提供 应 用 开发 者 在 应 用 中 更 好 地 
集成 Google 的 产品 。Maps API 是 Google Play Services SDK 的 一 部 分 。Google Play 
Service SDK 是 Android SDK 的 扩展 ,可 以 从 Android SDK 管理 器 下 载 ,下 载 文 件 中 包 
含 客户 端 库 和 示例 代码 。 要 使 用 Maps API, 必 须 首先 安装 Google Play Services SDK。 

安装 Google Play Services SDK 的 步骤 如 下 。 

(1) 下 载 安 装 Google Play Services SDK 包 。 

从 安装 了 ADT 的 Eclipse 平台 上 ,选择 Window 一 Android SDK Manager, 然 后 把 滚 
动 条 拖 到 包 列 表 的 底部 ,打开 Extras 选择 Google Play Services, 然 后 单 击 * 安 装 ?按钮 安 


装 ( 见 图 10. 3) 。 
SDK path: 
Packages 
PName _APL Rev Status 
vO Extras | 
@a Android Support Library | 0 | 久 Update available: rev. 11 
@ Google AdMob Ads SDK | | @ |¥ Notinstalled 
@a Google Analytics SDK | | 2 |¥ Notinstalled 
留 Google Cloud Messaging for Android Library 3 | 渴 Notinstalled 
” Google Play serv 4 看 Notinstalled 
留 Google Play APK Expansion Library | 2 | Notinstalled 
@a Google Play Billing Library | 3 |M Not instolled 
人 Google Play Licensing Library | 2 | Notinstalled 
a Google USB Driver | | 7 |¥ Notcompatible withLinux 
@ Google Web Driver | 2 |§ Notinstalled 
a Intelx86 Emulator Accelerator (HAXM) | | 2 | ¥ Not compatible with Linux 
Show: ”图 Updates/New 国 Installed  [ Obsolete Select NeworUpdates Install 1 package... | 
Sortby: @ APllevel O Repository Deselect All Delete packages. 
Done loading packages. J 


图 10.3 安装 Google Play Service SDK 包 


Google Play Services SDK 保存 在 二 android-sdk 二 /extras/google/google_play _ 
services/ 目 录 下 。 

(2) 导入 workspace。 

在 Eclipse 平台 上 ,选择 File 一 Import 一 Android 一 Existing Android Code into 
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Workspace, 然 后 会 显示 出 计算 机 上 所 下 载 Google Play Services Package 的 位 置 , 导 入 下 
载 的 包 。 

另 一 种 方式 是 直接 将 过 android-sdk 二 /extras/google/google _ play _ services/ 
libproject/google -play-services_lib/ 中 的 库 复 制 到 应 用 程序 project 所 在 的 目录 。 

可 以 根据 情况 选择 有 效 的 方式 。 


10.2.2.2 获取 Maps API 密 钥 


要 访问 谷歌 地 图 API 的 服务 器 ,必须 在 应 用 程序 中 添加 一 个 地 图 API 密 钥 。 申 请 密 
钥 是 免费 的 ,目前 在 开发 的 应 用 中 使 用 是 不 受 限制 的 , 它 支 持 无 限 数量 的 用 户 访问 。 使 用 
应 用 程序 的 签名 证 书 和 包 名 ,可 以 从 谷歌 API 控制 台 获 得 地 图 API 密 钥 。 一 旦 获得 API 
密 钥 ,就 可 以 将 它 添加 到 应 用 程序 的 AndroidManifest. xml 的 元 素 中 。 

地 图 API 密 钥 是 与 特定 的 签名 证 书 和 包 名 相对 应 ,而 与 用 户 或 应 用 程序 无 关 。 无 论 
应 用 程序 有 多 少 用 户 ,只 需要 每 个 证 书 一 个 密 钥 。 对 于 使 用 相同 的 证 书 应 用 程序 ,可 以 使 
用 相同 的 API 密 钥 。 但 是 ,推荐 的 做 法 是 每 个 应 用 程序 使 用 不 同 的 签名 证 书 , 并 为 每 个 
证 书 申请 一 个 不 同 的 密 钥 。 

应 用 程序 获取 Maps API 密 钥 的 过 程 主要 分 以 下 步骤 进行 详细 说 明 。 

1. 提取 应 用 程序 的 证 书信 息 

地 图 API 的 密 钥 是 基于 应 用 程序 数字 证 书 的 缩写 形式 , 即 SHA-1 指纹 ,产生 的 。 这 

里 的 指纹 ,是 指使 用 常用 的 SHA-1 散 列 算法 生成 的 唯一 文本 字符 串 。 由 于 指纹 是 唯一 
的 ,谷歌 地 图 使 用 它 作 为 确定 应 用 程序 的 一 种 方式 。 为 了 显示 证 书 的 SHA-1 指纹 ,首先 
要 确保 有 证 书 。 
在 使 用 Eclipse 开发 过 程 中 ,Android SDK 会 产生 两 种 证 书 : 
。 Debug cerficate: 当 使 用 Eclipse 创建 并 运行 调试 项 目 ,但 并 没有 发 布 应 用 时 ， 
Android SDK 会 自动 产生 这 个 项 目的 证 书 , 称 为 Debug certificate 或 debug-key。 
使 用 这 个 证 书 申请 的 密 钥 只 能 用 于 开发 和 调试 ,不 能 用 于 发 布 的 产品 。 
。 Release certificate: 当 应 用 程序 项 目 发 布 到 手机 上 时 ,Android SDK 会 自动 产生 
的 另 一 个 证 书 。 
在 Eclipse 下 ,选择 Windows 一 Prefs 一 Android->Build, 可 以 看 到 对 话 框 中 提供 的 
SHA-1 指纹 代码 。 

2. 在 Google APIs Console 上 注册 项 目 , 并 把 Maps API 作为 项 目的 一 个 服务 

一 旦 有 了 签名 证 书 指纹 ,就 可 以 在 谷歌 API 控制 台 上 申请 谷歌 地 图 API 密 钥 ,其 步 
又 如 下 。 

(1) 在 浏览 器 中 ,访问 谷歌 API 控制 台 (https://code. google. com/apis/console/)。 
如 果 之 前 没有 使 用 谷歌 API 控制 台 .系统 会 提示 创建 一 个 项 目 。 单 击 Create Project ,在 
控制 台 上 创建 一 个 新 的 项 目 , 默 认 名 称 为 API Project, 这 个 名 字 出 现在 浏览 器 的 左上 角 ， 
单 击 其 名 称 后 ,有 下 拉 菜 单 可 以 管理 该 项 目 。 如 果 之 前 已 经 使 用 谷歌 API 控制 台 ,将 立 
即 看 到 现 有 的 项 目 和 可 用 的 服务 的 列表 。 也 可 以 为 谷歌 地 图 API 新 建 一 个 项 目 , 只 要 在 
左上 角 选 择 项 目 名 称 , 然 后 单 击 Create。 
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(2) 在 主 窗口 中 ,应 该 会 看 到 一 个 API 和 服务 列表 。 如 果 没 有 ,就 从 左 侧 的 导航 栏 中 


选择 Service, 见 图 10. 4。 

(3) 在 主 窗口 显示 的 服务 列表 中 ,向 下 滚动 ,可 以 看 到 
Google Maps Android API v2 ,在 这 行 上 有 一 个 开关 ,将 开关 打 
开 , 见 图 10. 5。 

(4) 这 时 会 显示 谷歌 地 图 API 的 服务 条 款 。 如 果 同 意 服务 
条 款 , 请 单 击 服务 条 款 下 面 的 复 选 框 ,然后 单 击 Accept。 这 时 将 
返回 到 API 和 服务 列表 界面 。 

(5) 在 左边 的 导航 条 中 , 单 击 API Access。 


车 coooe Maps 故国 © I 


Google apis 
roject - 


图 10.4 API 和 服务 列表 


图 10.5 设置 Google Maps Android API v2 服务 开关 


(6) 在 右边 显示 的 界面 中 , 单 击 Create New Android Key…, 见 图 10. 6。 


Google apis 
My Project 
APlAccess 
Overview To prevent abuse, Google places limits on API requests. Using a valid OAuth token or API key a 
Services 
Authorized API Access 
API Access OAuth 2.0 allows users to share specific data with you (for example, 
Reports contact lists) while keeping their usemames, passwords, and other 
Information private. A single project may contain up to 20 client IDs. 


.eam more 


Create an OAuth 2.0 client ID… 


Use API keys to identify your project when you do not need to access user data. Leam more 


Simple APl Access 


Key for browser apps (with referers) 


API key: AIzaSyACP8z71082-4c4Bk_xmDhG61HLexi0BPWO 


Referers: Any referer allowed 
Activated on: Jan 11, 2013 1:23 AM 
Activated by: lars.vogel@gmail.com — you 


Create new Server key... | create new Browser koy.. | Ba 


图 10.6 创建 新 的 Android Key 


(7) 在 显示 的 界面 中 ,输入 SHA-1 证 书 指纹 ,后 面 加 一 个 分 号 ,然后 加 上 应 用 的 包 


名 , 单 击 Create 按钮 , 见 图 10.7。 


(8) Google API 控制 台 的 主 界面 上 ,会 有 一 个 Key for Android apps (with 


certificates) 显示 区 域 ,其 中 有 40 字符 API Key, 例 如 : 


RIzaSyBcV]1- cTICSeYFrZ85SuvNw7GEMDDLIRKGO0 
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Configure Android Key for API Project 四 


This key can be deployed in your Android applications. 


APIrequests are sent directly to Google fom your clients' Android devices. Google verifies thateach 
request originates fom an Android application that matches one ofthe certificate SHA1 fingerprints 
and package names listed below. You can discover the SHA1fingerprint of your developer cerificate 
using the following command: 


keytool -list -v -keystore mystore.keystoreLeam more 


Accept requests from an Android application with one of the certificate fingerprints and 
package names listed below- 
[BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75;com. exampl 
| -android-mapexample | 
| 

One SHAI certficate fingerprint and package name (separated by a semicolon) per line. Example: 
45:B5:E4:6F:36:AD: 0A:98:94:B4:02:66:2B:12:17:F2:56:26:A0:E0;com. exampl. 


‘ TT ' 


图 10.7 输入 SHA-1 证 书 指纹 


10.2.2.3 Application Manifest 中 初始 设置 


在 获取 Maps API 密 钥 之 后 ,需要 在 应 用 程序 项 目的 AndroidManifest. xml 文件 的 
过 application 之 元 素 中 ,增加 如 下 子 元 素 。 例 如 : 


<metar- data 
android:name= "com.google.android.maps.v2.REIT FEY" 
android:value= "your_api_ key"/> 


其 中 ,your_api_key 是 指 上 面 申请 的 Google Map API 密 钥 , 这 个 元 素 设 置 了 com 
. google. android. maps. v2. API KEY 的 值 ,应 用 中 的 MapFragment 需要 使 用 这 个 元 素 。 
因为 Google Map Android API V2 需要 OpenGL ES V2, 可 以 添加 一 个 二 uses-feature 二 
元 素 作 为 二 manifest 二 元 素 的 子 元 素 , 用 来 对 外 通知 应 用 的 配置 要 求 , 代 码 如 下 : 


< uses- feature 
android:glEsVersion= "0x00020000" 
android:required= "true"/> 


这 样 在 Google Play Store 上 ,对 于 不 支持 OpenGL ES V2 的 设备 将 不 显示 应 用 。 接 
下 来 ,还 需要 添加 权限 和 其 他 设置 ,例如 : 


< pemission 
android:name= "om.exanple.mapdemo .pemmission.MAPS RECEIVE" 
android:protectionLevel= "signature"/> 

< uses— permission android:name= "com.exanple.mapdemo .permission.MAPS RECETVE"/> 
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为 了 使 用 Google Map Android API 还 必须 添加 以 下 权限 ,其 中 包括 : 
android. permission. INTERNET: 使 用 谷歌 地 图 服务 器 下 载 地 图 图 块 。 


com. google. android. providers. gsf. permission. READ_GSERVICES: 允许 的 
API 来 访问 谷歌 基于 网 络 的 服务 。 


android. permission. WRITE_EXTERNAL_STORAGE: 允许 API 缓存 地 图 图 块 


数据 在 设备 的 外 部 存储 区 。 
下 面 的 权限 也 建议 应 用 程序 添加 。 不 过 ,如 果 应 用 程序 不 需要 访问 用 户 的 当前 位 置 ， 
就 可 以 忽略 。 


android. permission. ACCESS_COARSE_LOCATION: 允许 的 API 使 用 Wi-Fi 
或 移动 基站 数据 (或 两 者 ) 来 确定 设备 的 位 置 。 

android. permission. ACCESS_FINE_LOCATION: 允许 的 API 使 用 全 球 定位 系 
统 (GPS) ,在 一 个 很 小 的 区 域内 ,来 确定 设备 的 位 置 。 


<uses- permission android:name= "android.Permission.INTERNET"/> 

<uses- Permissicn android:name= 
"android.pemmission.WRITE FXTERNAL STORAGE"/> 

< uses- pemission android:name= 
"cam.google.android.providers.gsf.permission.READ GSERVICES"/> 

< uses— Permissicn android:name= 
"android.pemmission.AOCESS CORRSE IOCATION"/> 

< uses- Fermissicn android:name= "android.pemmi ssion.AOCESS FINE IOCTCON"/> 
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在 这 一 节 , 用 一 个 简单 的 例子 来 说 明 如 何在 用 户 界面 上 添加 地 图 功能 。 这 个 例子 实 
现 了 在 用 户 界面 上 按照 某 个 经 纬度 显示 标记 的 功能 。 

首先 按照 使 用 应 用 程序 的 debug-key 从 Google 网 站 上 获取 Maps API 密 钥 ,然后 在 
Manifest 文件 中 把 一 个 应 用 程序 所 需 的 API 密 钥 和 权限 设置 好 。 

在 完成 应 用 Google 地 图 的 准备 之 后 ,就 可 以 在 应 用 程序 中 使 用 Maps API 来 实现 地 
图 功能 。 

1. 配置 AndroidManifest. xml 


在 AndroidManifest. xml 文件 的 一 application 二 元素 中 ,增加 代码 10. 10 的 子 元 素 。 
代码 10.10 AndroidManifest. xml 


< ?anl versior= "1 .0" encoding= "utf- 8"2> 

< manifest xmlns:android= "http://schemas.android.om/apk/res/android" 
Package= "om.vogella.android.locationapi .maps" 
android:versionCode= "1" 
android:versionName= "1.0"> 


< uses— sdk 
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2. 调整 布局 文件 
在 这 个 例子 中 ,使 用 MapFragment 来 显示 地 图 。 如 果 要 在 Activity 中 添加 一 个 
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Fragment 对 象 来 处 理 地 图 操作 ,最 简单 的 方法 是 在 布局 文件 中 增加 一 个 二 fragment 二 元 
素 。 在 该 元 素 中 ,设置 android: name 属性 值 为 com. google. android. gms. maps 
. MapFragment, 使 MapFragment 自动 附加 到 Activity 中 。 具 体 设 置 见 代码 10. 11。 

代码 10. 11 Fragment 设置 


< RelativeLayout xmlns:android= "http://scheras-android.camVapk/res/android" 
smlns:tools= "http://schemas.android.omm/tools" 
android:layout width "match parent" 
android:layout height= "match Parentn 
tools:context= ".MainActivity"> 


< fragment 
android:id= "@ + id/map" 
android: layout width= "match Parentn 
android: layout height= "match parent" 
android:name= "om.google.android.gns .maps .MapFragment"/> 


< /RelativeLayout> 


除了 从 布局 文件 中 设置 MapFragment 的 方法 ,还 可 以 通过 编码 的 方式 在 Activity 中 
添加 一 个 MapFragment 对 象 。 使 用 这 种 方式 ,首选 要 创建 一 个 新 的 MapFragment 实例 ， 
然后 调用 FragmentTransaction. add() 方 法 将 Fragment 添加 到 当前 的 Activity 中 , 见 代 
码 10.11。 


MapFragment— MapF ragment .newInstanoe (); 
nm 下 全 下 

getFragmentManager () .beginTransaction(); 
fragmentTransaction.add (R.id.my_oontainer, mMapFragment); 
fragment Transaction.oommit (); 


3. 获取 GoogleMap 对 象 

在 定义 完 布局 文件 之 后 ,就 可 以 进行 Activity 的 编码 。 在 Activity 中 导入 前 面 定义 的 布 
局 文件 之 后 ,可 以 调用 FragmentManager. findFragmentById() 方 法 ,以 apFragment 的 资源 
ID 作为 参数 ,获取 布局 文件 中 二 fragment 二 元 素 定义 的 MapFragment 对 象 。 调 
MapFragment 的 getMap() 方 法 就 可 以 获得 GoogleMap 对 象 的 句柄 ,例如 : 


Private GoogleMap rMap; 


mMap= ( MapEragment) 
getFragmentManager () .findFragmentById (R.id.map)) .getMap(); 


得 到 GoogleMap 对 象 后 ,就 可 以 设置 地 图 的 初始 选项 。 但 是 在 使 用 GoogleMap 对 
象 之 前 ,需要 确认 这 个 对 象 是 否 应 用 被 实例 化 .可 以 通过 一 个 方法 检查 GoodMap 对 象 是 
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和 否 为 null, 如 果 为 null 则 需要 执行 实例 化 的 代码 ,例如 下 面 定义 的 方法 ,该 方法 可 以 在 
Activtiy 的 onCreate() 和 onResume() 方 法 中 调用 ,以 确保 GoogleMap 对 象 总 是 可 用 的 : 


代码 10. 12 是 例子 中 Activity 地 图 显示 的 完整 代码 ,这 个 代码 比较 简单 ,实现 了 基本 
的 功能 。 
代码 10.12 添加 地 图 


入 加/ 基于 Adroid 平 台 的 移动 互联 网 开发 


//Zom in，animating the camera 
map.animateCamera (CameraUpdateFactory.zomlTo (10), 2000, null); 
} 


@ Overrige 
public boolean onCreateOptionsMenu (Menu menu) { 
getMenuTnflater() .inflate (R.menu.activity main, menu); 
retum true; 
} 
} 


4. 设置 地 图 

除了 最 基本 的 地 图 操作 之 外 ,Google Map Android API 还 提供 了 其 他 的 一 些 功能 。 
其 中 包括 地 图 类 型 的 设置 。Google Map Android API 提供 了 4 种 类 型 的 地 图 。 

。 normal: 典型 的 路 线 图 ,其 显示 道路 、 某 些 人 造 的 以 及 重要 的 自然 特征 ,例如 河流 
等 。 公 路 和 特征 的 标签 也 是 可 见 的 。 
Hybrid: 在 路 线 图 上 增加 了 卫星 照片 数据 ,公路 和 特征 的 标签 也 是 可 见 的 。 
Satellite: 卫星 照片 数据 ,公路 和 特征 的 标签 是 不 可 见 的 。 
Terrain: 地 形 数据 。 该 地 图 包含 的 颜色 、 轮 廓 线 和 标签 、 透 视 阴影 。 某 些 道 路 和 
标签 也 是 可 见 的 。 
none: 没有 图 块 。 该 地 图 将 呈现 为 一 个 空 的 网 格 没 有 图 块 的 加 载 。 

要 设置 地 图 的 类 型 ,可 以 调用 GoogleMap 对 象 的 setMapType() 方 法 ,并 且 传递 地 图 
类 型 常量 。 例 如 ,要 显示 的 卫星 地 图 ,设置 代码 如 下 : 


GoogleMap map; 


//Sets the map type to be "hybrid" 
map. setMapType (GoogleMap.MAP_TYPE, HYBRID); 


图 10. 8 显示 了 相同 位 置 的 normal、hybrid 和 terrain 三 种 类 型 地 图 。 

5. 设置 初始 状态 

在 Maps API 的 应 用 中 ,可 以 设 定 地 图 的 初始 状态 ,以 满足 应 用 程序 的 需求 。 这 些 其 
中 包括 摄像 机 的 位 置 缩放 ,方位 和 倾斜 ;地 图 显示 类 型 ;是 否 缩 放 按 钮 .罗盘 显示 在 屏幕 
上 ;用 户 使 用 的 手势 ,用 来 操作 相机 。 可 以 通过 XML 布局 文件 配置 的 初始 状态 ,也 可 以 
通过 编程 的 方式 。 

如 果 使 用 XML 布局 文件 添加 了 地 图 应 用 .地 图 为 MapFragment 和 MapView 定义 
了 一 组 自 定 义 的 XML 属性 ,可 以 在 布局 文件 中 直接 定义 初始 状态 ,目前 这 些 属性 包括 : 

。 mapType: 可 以 指定 地 图 类 型 的 种 类 ,其 值 可 以 是 none、 normal, satellite 和 

terrain。 


*。 cameraTargetLat, cameraTargetLng, cameraZoom, cameraBearing, cameraTilt: 
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10.8 同一 位 置 的 normal .hybrid 和 terrain 三 种 类 型 地 图 


可 以 指定 初始 摄像 机 的 位 置 。 
uiZoomControls,uiCompass: 可 以 指定 是 否 要 在 地 图 上 显示 缩放 控制 和 指南 针 。 
uiZoomGestures, uiScrollGestures, uiRotateGestures, uiTiltGestures: 可 以 指定 
各 种 与 地 图 交换 手势 的 启用 或 禁用 。 
zOrderOnTop: 控制 地 图 视图 的 表面 是 否 被 放置 在 其 窗口 的 顶部 。 
useViewLifecycle: 只 适 于 MapFragment。 此 属性 指定 是 否 应 该 将 地 图 的 生命 周 
期 连接 到 片段 的 视图 或 片段 本 身 。 

为 了 在 XML 布局 文件 中 使 用 这 些 自 定义 的 属性 ,必须 首先 添加 下 面 的 命名 空间 声 
明 。 命 名 空间 的 名 称 可 以 任何 选择 ,不 一 定 是 map。 


xmlns:map= "http://schemas.android.comyapkyVres- auto" 


如 果 命 名 空间 的 名 称 为 map, 则 使 用 “map:” 作 为 前 缀 添加 地 图 属性 。 代 码 10. 13 的 
XML 代码 显示 如 何 配置 MapFragment, 其 中 使 用 了 一 些 自 定义 的 选项 。 相 同 的 属性 也 
可 以 应 用 到 MapView 上 。 

代码 10.13 地 图 属性 初始 化 


< fragment xmlns:android= "http://schemas.android.oam/apk/res/android" 
mlns:map= "http://schemas.android.coam/apk/res-— auto™" 
android:id- "@ + id/map" 
android: layout width= "match parent" 
android: layout height= "match parent" 
android:name= "com.google.android.gms .maps.SupportMapEragment" 
map:cameraBearing= "112.5" 


Dd 
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map:cameraTargetLat= "— 33.796923" 
map:cameraTargetIng= "150.922433" 
map:cameraTilt= "30" 
map:cameraZoom= "13" 
map:mapType= "nomal" 
map:uiCanpass= "false" 
map:uiRotateGestures= "true" 
map:uiScrollGestures= "false" 
map:uiTiltGestures= "true" 
map:uiZomControls= "false" 
map:uiZomGestures= "true"/> 


如 果 要 通过 编程 的 方式 配置 MapFragment 或 MapView 初始 状态 ,需要 定义 
GoogleMapOptions 对 象 ,并 且 使 用 此 对 象 创建 MapFragment 或 MapView。 首 先 需要 创 
建 GoogleMapOptions 对 象 ; 


GoogleMapOptions options= new GoogleMapOptions(); 
然后 为 GoogleMapOptions 对 象 增 加 配置 项 ,代码 如 下 : 


Ptions .mapType (GoogleMap.MAP TYPE SATELLITE) 
.CpassEnabled (false) 
.rotateGesturesEnabled (false) 
-tiltGesturesEnabled (false); 


6. 地 图 标记 

标记 可 以 用 来 识别 地 图 上 的 某 一 位 置 。 其 使 用 标准 的 图 标 , 与 常见 的 谷歌 地 图 的 外 
观 相似 ,可 以 通过 API 改变 标记 的 颜色 、 图 片 或 锚 点 , 自 定义 图 像 。 标 记 是 Marker 类 型 
的 对 象 ,通过 GoogleMap. addMarker(markerOptions) 方 法 添加 到 地 图 上 。 标 记 的 图 标 
是 针对 设备 的 屏幕 绘制 的 ,而 不 是 在 地 图 的 表面 ,所 以 地 图 发 生 了 旋转 、 倾 斜 或 变焦 不 一 
定 会 改变 标记 的 方向 。 

当 用 户 在 地 图 上 单 击 一 个 标记 时 ,可 以 使 用 信息 窗口 给 用 户 显 示 信 息 。 默 认 情 况 下 ， 
如 果 标 记 有 一 个 标题 , 当 用 户 单 击 一 个 标记 时 ,消息 窗口 被 显示 ,而 且 同 一 时 间 只 显示 一 
个 信息 窗口 。 如 果 用 户 单 击 另 一 个 标记 ,当前 标记 的 消息 窗口 会 被 隐藏 ,新 的 消息 窗口 将 
显示 。 可 以 通过 调用 标记 的 showInfoWindow () 方 法 ,显示 信息 窗口 ,通过 调用 
hideInfoWindow() 方 法 隐藏 消息 窗口 。 消 息 窗口 与 标记 一 样 ,是 被 绘制 在 设备 屏幕 上 
的 ,是 在 标记 中 心 的 上 面 。 默 认 的 消息 窗口 包含 黑体 的 标题 ,在 标题 下 面 也 可 以 有 一 小 段 
交 汪 5 

如 果 将 标记 的 draggable 属性 设置 为 true, 则 允许 用 户 更 改 标记 的 位 置 ;如 果 对 标记 
进行 长 按 操 作 , 可 以 激活 移动 功能 。 代 码 10. 14 中 为 地 图 添加 了 一 个 标记 ,其 坐标 为 (0， 
0) , 当 单 击 时 在 消息 窗口 上 显示 字符 串 “Hello world”。 
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代码 10.14 添加 标记 


getEragmentManager () .findFragmentByTd(R.id.map) ) .getMap() 7 
Map.addMerker (new Markeroptions() 

-Positicn (new LatIng(0, 0)) 

.title ("Hello world")); 


如 果 改 变 默认 的 标记 图 像 的 颜色 ,需要 传递 BitmapDescriptor 对 象 给 icon() 方 法 。 
可 以 在 BitmapDescriptorFactory 对 象 上 使 用 一 组 预定 义 颜 色 , 或 使 用 
BitmapDescriptorFactory. defaultMarker(float hue) 方 法 设置 一 个 自 定 义 的 标记 颜色 , 色 
调 的 值 介 于 0 和 360 之 间 , 见 代码 10. 15。 

代码 10.15 ”改变 标记 颜色 


static final LatIng MTBOURNE= new IatIng (- 37.81319, 144.96298); 
.position METBOURNE) 
title ("Melbourne") 
.snippet ("Population: 4,137,400") 
:HUE AZURE))); 

如 果 想 设置 更 多 标记 的 属性 ,而 不 仅仅 是 颜色 ,就 可 以 设置 一 个 自 定义 标记 图 像 ,通常 
被 称 为 图 标 。 这 种 自 定义 图 标 被 设置 为 BitmapDescriptor, 可 以 由 BitmapDescriptorFactory 
类 的 下 面 四 种 方法 之 一 在 定义 。 

。 fromAsset(String assetName) : 创建 一 个 自 定义 的 标记 ,使 用 的 /asset 目录 中 的 

图 像 。 

。 fromBitmap (Bitmap image): 从 位 图 图 像 创建 一 个 自 定义 的 标记 。 
fromFile (String path): 在 指定 的 路 径 从 一 个 文件 创建 一 个 自 定义 图 标 。 

。 fromResource (int resourceId) : 创建 一 个 自 定义 的 标记 ,使 用 现 有 的 资源 。 
代码 10. 16 , 列 出 了 创建 一 个 自 定义 图 标的 代码 。 
代码 10.16 创建 一 个 自 定义 图 标 


private static final LatIng METBOURNE= new IatIng(- 37.81319, 144.96298); 
private Marker melbourne= rmMap.addMarker (new MarkerOptions () 
-title("Melboune") 
.snippet ("Population: 4,137,400") 
.icon (BitmapDescriptorFactory.fromRescource (R.drawable.arrow) )); 


在 应 用 程序 中 也 可 以 监听 和 响应 地 图 标记 上 的 事件 。 要 监听 这 些 事件 ,必须 为 标记 
在 GoogleMap 的 对 象 上 设置 相应 的 监听 器 。 当 事件 发 生 在 地 图 上 的 一 个 标记 时 ,监听 器 


基于 Anrdroid 平 台 的 移动 互联 网 开发 


的 回调 方法 将 会 被 调用 ,并 且 传 人 相应 的 标记 对 象 作 为 参数 。 在 判断 标记 引用 时 ,必须 使 
用 此 标记 的 equals 〇 方法 ,而 不 是 “二 二 ”。 可 以 监听 的 事件 包括 标记 单 击 事件 、 标 记 拖 动 
事件 .信息 窗口 的 单 击 事件 。 

Maps API 针对 不 同 的 操作 提供 不 同 的 监听 器 。 监 听 器 OnMarkerClickListener 可 以 监 
听 标 记 的 单 击 事件 ,OnMarkerDragListener 监听 标记 拖 动 事件 ,OnInfoWindowClickListener 
监听 信息 窗口 的 单 击 事件 。 在 默认 情况 下 ,标记 是 不 能 拖 动 的 。 必 须 明 确 地 设置 为 可 拖 
动 , 标 记 才 可 以 由 用 户 拖 动 。 

7. 绘制 形状 

可 以 使 用 Google Maps API for Android 在 地 图 上 添加 折线 、 多 边 形 和 圆 形 。 折 线 是 
一 系列 相连 的 线段 ,可 以 形成 任何 想 要 的 形状 ,可 以 用 来 标记 在 地 图 上 的 路 径 和 路 线 ; 多 
边 形 和 圆 形 都 是 一 个 封闭 的 形状 ,可 以 用 于 标记 在 地 图 上 的 地 区 。 它 们 都 有 着 相似 的 性 
能 ,并 允许 自 定义 线条 的 颜色 、 宽 度 等 。 

使 用 Polyline 类 在 地 图 上 定义 一 系列 连接 的 线段 。 一 个 Polyline 对 象 包括 了 一 系列 
LatLng 位 置 对 象 ,将 这 些 LatLng 对 象 按照 顺序 连接 起 来 就 形成 了 折线 。 要 创建 一 个 折 
线 ,首先 创建 一 个 PolylineOptions 的 对 象 , 然 后 添加 位 置 点 。 位 置 点 代表 地 球 表面 上 的 
由 经 度 和 纬度 决定 的 一 个 点 ,定义 为 一 个 LatLng 对 象 。 将 这 些 点 添加 PolylineOptions 
对 象 中 ,线段 是 按照 点 与 点 之 间 的 顺序 绘制 而 成 的 。 要 将 添加 点 到 PolylineOptions 对 象 
中 ,需要 调用 PolylineOptions. add( ) 方 法 。 可 以 连续 使 用 这 个 方法 一 次 添加 多 个 点 。 添 
加 折线 的 步骤 为 : 

(1) 实例 化 新 的 PolylineOptions 对 象 。 

(2) 设置 的 LatLng 对 象 ,用 PolylineOptions. add() 方 法 添加 点 。 

(3) 根据 需要 设置 其 他 的 属性 。 

(4) 调用 GoogleMap. addPolyLine 添加 一 个 折线 所 指定 的 地 图 PolylineOptions。 

(5) 折线 显示 在 地 图 上 。 

在 地 图 上 定义 一 个 多 边 形 的 方法 与 定义 折线 是 相似 的 ,都 是 有 很 多 由 经 度 和 纬度 确 
定 的 位 置 点 组 成 的 ,但 多 边 形 是 封闭 的 ,而 折线 不 是 。 代 码 10. 17 示例 了 添加 一 个 长 方形 
在 地 图 上 的 一 段 代 码 。 

代码 10.17 创建 形状 


//Instantiates a new Polyline cbject and adds points to define a rectangle 
PolylineOptions rectOptions= new PolylineOptions() 
-add (new LatIng (37.35,— 122.0)) 
-add (new IatLng(37.45,- 122.0)) //North of the previous point, but at the same longitude 
.add (new LatIng (37.45,— 122.2)) //Same latitude, and 30km to the west 
.add (new LatIng (37.35,- 122.2)) //Same longitude, and 16km to the south 
.add (new IatIng(37.35,- 122.0)); //Closes the polyline 


//set the rectangle's color to red 
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Tectopticns-color (Color.FED); 


//Get back the mutable Polyline 
Folyline polyline= myMap.addPolyline (rectopticns); 


图 10.9 显示 了 代码 10. 17 运行 后 的 效果 。 


在 地 图 


二 
面 | MapsTest 


Monte Bello Open 条 
Space Preseve 


oma Maf ® Pescadero Greek 
County Park 


图 10.9 在 地 图 上 绘制 矩形 运行 结果 


上 定义 圆 形 的 过 程 与 其 他 形状 有 所 不 同 ,需要 定义 两 个 属性 。 一 个 是 中 心 点 ， 


用 LatLng 表示 ; 另 一 个 是 半径 .以 米 为 单位 。 


际 看 到 的 是 
示 会 变 成 非 


圆 形 代表 地 球 表面 一 个 给 定 中 心 点 和 半径 所 确定 区 域 的 所 有 点 集合 。 由 于 实 
一 个 投影 ,如 果 半 径 比 较 小 则 看 到 的 是 几乎 完美 的 圆 形 , 但 随 着 半径 的 增加 显 
圆 形 。 


代码 10. 18 示例 了 添加 一 个 圆 形 的 代码 。 首 先 创建 一 个 CircleOptions 的 对 象 , 然 后 
调用 GoogleMap. addCircle(CircleOptions) 方 法 。 
代码 10.18 添加 圆 形 


//Instantiates a new Polygon cbject and adds points to define a rectangle 
Circleoptions circleOptions= new Circleoptions() 
-center (new IatIng (37.4,— 122.1)) 
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-radius (1000) ); //In meters 


//Get back the mutable Circle 
Circle circler myMap.addcircle (circleOptions); 


圆 形 被 添加 后 ,如 果 要 改变 其 形状 ,可 以 调用 Circle. setRadius() 或 Circle. setCenter() 
方法 。 


10.3 小 结 


本 章 主 要 介绍 了 Android 应 用 程序 如 何 使 用 实现 定位 服务 和 地 图 服务 。 

Android 通过 android. location 包 中 的 类 为 应 用 程序 提供 定位 服务 。 定 位 框架 中 的 
核心 组 件 就 是 LocationManager 系统 服务 ,其 提供 了 支撑 底层 设备 的 定位 API。Android 
设备 可 以 使 用 GPS 和 Android 网 络 位 置 提 供 器 (Android Network Location Provider， 
NLP) 来 提供 位 置信 息 ,提供 与 位 置 相关 的 服务 。 

Android 应 用 程序 通过 调用 Google Maps Android API( 简 称 Maps APD) 来 实现 基于 
Google Maps 的 地 图 服务 。Maps API 可 以 自动 处 理 对 Google Maps 服务 器 的 访问 、 数 
据 下 载 . 地 图 显示 和 地 图 手势 的 事件 响应 。 在 Maps API 中 ,常用 的 重要 类 包括 
GoogleMap、MapFragment、MapView 和 Marker。Android 应 用 程序 在 使 用 Maps API 
之 前 ,需要 安装 Google Play services SDK ,获取 Maps API 密 钥 , 并 进行 menifest 文件 中 
的 密 钥 和 权限 设置 。 
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